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INTRODUCTION 


This manual is written for the Cromix-Plus system administrator. The system 
administrator is assumed to have overall responsibility for: 


1. Installing system hardware and software. 


2. Assigning user identification numbers, group identification numbers, and 
passwords to system users, and safeguarding system security. 


3. Regularly copying important user files to a backup storage medium (floppy 
diskette, another hard disk drive, or magnetic tape). 


4. Handling system hardware and software problems as they arise. 


The manual. presents administrative tasks chronologically. Chapter 1 discusses 
_ some fundamental ideas that should clarify why you perform eertein steps in 
later chapters. 


In chapter 2, you will start up the system for the first time. This chapter 
includes procedures for copying the Cromix-Plus software from the 
factory ~shipped system disks to the hard disk, bringing the hard disk on-line, 
and making copies of the system disks for safekeeping. — 


In chapter 3, you will modify certain files and programs on the hard disk for 
compatibility with your system's peripheral hardware. Chapters 4 and 5 
describe how to set up and install the standard peripherals and printed circuit 
boards. 


This manual assumes the reader has a basic understanding of programming (any 
language), files and file operations (creating, editing, copying, moving, deleting), 
and the basie functions of devices like a CPU, RAM, interface boards, terminals, 
and the like. Since Cromix-Plus is designed to take advantage of the large 
storage capacity and high data transfer rates of a hard disk, this manual also 
assumes that your system includes a hard disk. The operating system can be 
set up to run from a floppy disk, but this is normally done only to diagnose 
system faults with the hard disk off-line. 
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For more information on a particular Cromemco product, refer to the appropriate 
manual listed below. You can obtain copies from your Cromemco dealer. 


- Cromemeco 
023-2004 


a a part number 


Cromemco_Cromix-Plus User's Reference Manual, part number 023-5018 


Cromemeo Cromix-Plus Programmer's Reference Manual, part number 
023-5014 


Cromemeo XPU_Instruction Manual, part number 023-2029 
Cromemco_68000 Roard Family Instruction Manual, part number 023-2016 
Cromemco M-Series Memory Roard Family, part number 023-2033 


Cromemca 256KZ Random Access Memory Instruction Manual, part number 
023-2021 


Cromemco 64FDC Floppy Disk Controller Instruction Manual, part number 
023-2022 


16F DC Disk Controller Instruction Manual, part number 


Cromemeo STDC Disk Controller Instruction Manual, part number 023-2031 


CromemesQctart Asynchronous Communications Processor, part number. 
023-2028 


ee eee part number 


oe EE eS eee part number 


———————— Instruction. Manual, part number 
023-0011 


Cromemeo PRI Printer Interface Instruction Manual, part number 023-0055 
Crememeo C-Net User Manual, part number 023-4059 
Cromemeo C-10 Personal Computer User Manual, 


Croememeo XXU_ Instruction Manual part number 023-6037 
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Chapter 1 


CROMIX SYSTEM FUNDAMENTALS 


This chapter presents fundamental background material for later chapters. It 
defines frequently used terms (important terms appear boldfaced when first 
introduced), and discusses key concepts common to all Cromix-Plus Systems. 


PROGRAM CROMIX.SYS 


The program /cromix.sys is the heart of the Cromix-Plus operating system, 
and always resides in system memory. "Booting" the operating system consists 
essentially of loading the file /eromix.sys into system memory and executing 
it. 


The program /cromix.sys has three major components: the kernel, the 
management of system calls, and the drivers. 


The Kernel is the program that ae execu tes when the asciaets cs 
is booted. ; 


Programs that are executed by users (user programs) require assistance from 
the operating system to provide functions which they do not (and should not) 
provide themselves. This assistance is provided via system calls. A system 
call is an operating system supplied subroutine which provides service to user 
programs. 


The Kernel and the system call routines must provide access to the actual I/O 
devices in order for them to do their jobs. The routines to access such devices 
are organized into drivers. A driver is a set of functions that manage one 
particular device (or class of devices). As there are many possible devices, 
there are many different drivers. If a particular device does not exist on a 
system, there is no need to have the drivers for that device linked into the 
operating system. This means that the user will have to build a customized 
version of /cromix.sys that best suits the system configuration. The distributed 
version of /eromix.sys is an example of a /cromix.sys file that can be built. 
This is a very generalized version of /cromix.sys and contains drivers to most 
Cromemeco peripherals. It was so constructed to enable a user with almost any 
hardware configuration to boot and then generate a customized version. 


Cromix-Plus is a multi-user, multi-tasking operating system. This means that 
there will be a number of user processes (programs) executing simultaneously. 
It is the responsibility of the operating system to manage such execution. The 
operating system must ellocate the system resources to user processes (memory, 
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1/O devices, processor time) The operating system must start each user process 
and then manage its execution. While user processes are running, the operating 
system must handle their system calls. The access to all resources that might 
be shared between processes (like I/O devices) must be managed by the operating 
system to prevent intentional or unintentional misuse. 


At the start, the Kernel executes as any other program. It initializes a number 
of data structures. The most crucial data structure is the array of process 
tables. Each process table contains information about one user process. 


Once all data structures are initialized, the Kernel creates process one. The 
code for process one is read from the file /ete/p_one.bin and this process 
is declared to be ready for execution. The Kernel code now degenerates into 
the scheduler. The scheduler is a simple loop which finds a process ready for 
execution, ensures that the process executes for a time slice, and looks for 
another process to execute. If there is no process ready to execute, the 
scheduler simply waits until a process becomes ready. As long as there is at 
least one process alive there is a chance that this process will become ready 
and that execution will resume. 


Every process has the means to create other processes. If, at any time, the 
scheduler determines that there are no processes remaining, it knows there is 
no possibility of creating any others, therefore the program /cromix.sys can 
' terminate its execution. This-is what happens when the shutdown command is 
~ executed. ey , 


As long as the system is running, process one stays alive. Process one has 
three functions: : 

“= it creates (and kills) the gtty processes 

~ it kills all processes, including itself, on shutdown 


~ it declares itself to be the parent process of a process whose 
parent was killed for any reason 


At the very beginning, and whenever the command: 

system[1] kill -1 1 
is issued, process one inspects the /ete/ttys file. This file lists all possible 
terminals together with a flag which indicates whether the terminal should be 


used. When process one inspects the /ete/ttys file it does the following: 


- If a terminal is disabled, process one will kill all processes 
(if any) that were started from that terminal. 


- If aterminal is enabled, but no process started from that terminal 
is running, process one will create a gtty process for that 
terminal. 


A gtty process is in fact a sequence of three programs: , 


/ete/gtty.bin 
/ete/login.bin 


Cromemeo Cromix-Plus System Administrator's Guide 
1. Cromix System Fundamentals 


/ete/shell .bin 
The gtty program is a very simple program that: 


~ displays the file /etc/weleome 
- displays the message: 


Login: 
- waits for some user input 


When any line is typed to the terminal, the gtty program replaces itself with 
the login program. The login program assumes the line which the user entered 
is the login name. The login program checks the /ete/passwd file to determine 
if such a user name exists. If it exists, and the /ete/passwd file contains a 
password associated with it, the login program prompts the user for the 
password. If there is no such user name, or if the user does not enter the 
correct password, the login program reverts to the gtty program. In the 
opposite case, the login program replaces itself with the program 
/ete/shell.bin. When the shell program terminates execution, the 
gtty-login-shell chain has been successfully completed. Process one then 
starts a new gtty process. 


The Shell program. is the means of communication with. the operating sy stem. 
- The Shell program will repeatedly display a prompt, usually the user name: 
followed by the command number in brackets, CoG? 


¢ sy stem[1] 
(see the description’ of the Passwd ‘utility for ways to customize the prompt) 
and wait for a command to be entered. When the user enters a command, the 
Shell will try to execute it and then display the next prompt. If the command - 
entered is: 
sy stem[1] exit 


the Shell will terminate its execution. 


ROOT DEVICE 


When Cromix-Plus is booted it must decide which device is going to be the root 
device. The root device is the device which contains the / directory. 


The root device can be selected by three possible methods. The actual method 
is determined when /cromix.sys is generated. These three possibilities are: 


- during system initialization, prompt the operator for which device 
to use 

- use a predefined device 

~ use the same device from which the file /cromix.sys was read 
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The distribution version of /eromix.sys is generated to prompt the operator 
for which device to use. When the file /cromix.sys is custom generated, the 
root device number can be included so that the operator need not be prompted. 
Note that a customized /cromix.sys may not work if transfered to another 
sy stem. 


THE FACTORY-SHIPPED SYSTEM DISKS 


Cromix-Plus software is supplied from the factory on a number of 8" or 5-1/4" 
floppy diskettes called system disks. The system disks are protected against 
writing and should never be enabled for writing by: 


- adding a write enable sticker on an 8" system disk 
~ removing the write protect sticker from an 5-1/4" system disk 


System disks should be copied and then stored in a safe place. 


Disk #1 (5-1/4") 


This disk is bootable. A bootable disk means it contains a boot track 
and can be used as the root device. Disk #1 contains a minimal 
Cromix~-Plus file structure and should be used only for these tasks: 


- To check, via the check command, the integrity of the file 
system on the hard disk (or hard disk partition) which is 
intended for use as the root device. 


-=- To correct problems in'the file structure on the hard disk. . 
- Torun the updatel command file to update the hard disk. 
Disk #2 (5-1/4") 
This disk is also bootable. It also contains the minimal Cromix-Plus 
file structure. The disk should be used to initialize the hard disks, 
to build file structures on them, to check the file system integrity, 
ete. Once you have a good file structure on the hard disk you must 
reboot disk #1 to run the Updatel command. Later, if you run into 


trouble with your hard disk you will have to boot this disk again to 
correct any problems. 


The remaining disks are in ftar format. They are used in the second step of the 
update procedure (update2 command). 
Disk_#1 (8") 


This disk is bootable and contains all utilities from the 5-1/4" disks 
#1 and #2. 


The remaining disks are in ftar format. They are used in the second step of the 
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update procedure (update2 command). 


COLD BOOT PROCESS 


The XXU board contains a Programmable Read Only Memory (PROM) chip that 
contains the XDOS (XXU Disk Operating System) program. Upon system reset 
or power up, it is the XDOS program that begins execution. XDOS can establish 
communication with one of the possible terminals. This terminal is called the 
boot terminal. The boot terminal is used by XDOS to display messages and 
questions to the operator. The operator uses it to type commands and responses 
to XDOS. XDOS also performs initial diagnostics and is responsible for booting 
the operating system 


In order to boot the system, XDOS must be told from which device to boot. XDOS 
reads the bootstrap program from the boot device, loads it into memory and 
executes it. The bootstrap program then reads the program to be booted (usually 
/cromix.sys), loads it into memory and executes it. The details of this process 
are described in the next chapter. 


WARM BOOT PROCESS 


If .Cromix is already running, a privileged user can boot the system without 
reseting the computer. This is called a "warm boot". Warm booting means that 
a new copy of the operating system will be loaded into memory and executed. 
All running processes will be killed and the old operating system will terminate. 
The new copy of the operating system will peep execution as if it were loaded 
by. aia and the bootstrap program. 


It is very ; epoe tant to ensure that all users are foceweriied prior to performing 
a warm boot. A warm boot kills all processes and valuable work could be lost. 


Use the msg utility to warn all users to log off the system. Use the 
system[1] pstat -al 


command to determine what processes are still running. Processes normally 
present are: 


Process One (Command "-") 
Flush 

A number of gtty processes 
A number of Shell processes 


If any other processes are listed, a warm boot is probably ill advised until they 
terminate. The Ctty column of the pstat command shows the major and minor 
device number of the terminal from which the concerned processes were started. 


Once it is clear that the system can safely be warm booted, execute the boot 
eommand. For example: 


sy stem[1] boot /gen/cromix 
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The boot utility can warm boot any file within the file system which has the 
«Sys extension. A cold boot using XDOS and the bootstrap program, can load 
and execute only the file /eromix.sys from the root directory. 


STOPPING THE SYSTEM 
A privileged user can stop the system by executing the command: 
system[1] kill -2 1 


This command will immediately kill all user processes, flush all buffers and 
close all devices. The processor will then execute the stop instruction. As 
sudden execution of the kill -2 1 command might terminate some important 
processes, the same precautions should be observed as in the case of a warm 
boot (see above). 


There is a more elegant way of stopping the system. The shutdown command 
(/emd/shutdown.emd) issues a warning message to all users, waits for 5 
seconds, and then issues the kill -2 1 command. /emd/shutdown.emd can be 
modified to extend the period users have to log off. Also, aborting shutdown 
during the waiting period will cause the kill -2 1 command not to be issued. 


‘WARNING: Do NOT reset the system or power down the system without 
executing the shutdown or kill -2 1 command! Data may be-lost. 


Once the operating system has been stopped, all diskettes, tapes, floppy tapes, 
etc. must be removed from their drives before turning off the power. 


’ If the system isreset or turned off without these precautions, for example during ~ 
a power failure, file systems on disk devices might be damaged. Use the check 
utility to verify file system integrity before rebooting the system. A damaged 
file system may degenerate with continued use. 


Keep the flush utility running in the background at all times. The flush utility 
will periodically write all data from system buffers to disk devices. This can 
greatly minimize the damage caused by an unexpected power failure. 

As no storage media is perfect, periodic backup of hard disks is essential. 
Copying hard disk files to another hard disk, to floppy diskettes, nine track tape 
or floppy tape can help avoid loss of data due to power failures. 

BOOT DISK 

Any disk device (floppy diskette or hard disk partition) can be used as the boot 
disk, provided XDOS knows how to read it. The following are the minimal 


requirements for a Cromix-Plus boot device: 


1. Use the initflop or inithard utility to initialize the device for 
Cromix-Plus. 


2. Use the makfs utility to build an empty file structure on it. 
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3. Use the wboot utility to write the bootstrap program to it. 


4. ‘Transfer the file cromix.sys to the root directory of the new 
file structure. 


The boot disk is a device that can be mounted via the mount utility. It must 
at least contain the file cromix.sys. The boot device may or MAY NOT be the 
same as the root device. 


ROOT DISK 


The root disk is normally a hard disk partition, although a floppy disk is 
occasionally useful as a root device. The root disk normally contains all the 
files distributed with Cromix-Plus (approx. 2 Mbytes). Floppy diskettes 
(especially 5 1/4") are restrictive in size, therefore building a root disk on a 
floppy requires a very careful selection of files. 


When the root disk is generated by the procedures described further in this 
chapter, the root disk will contain: , 


/cromix.sy s The operating system itself, used by the cold boot (or 
warm boot) procedure. 


/bin Directory that contains most of the Cromix-Plus — 
utilities. Additional programs may be added at the 
system administrator's discretion. 


/emd _ Directory. that contains a. few. standard command files. 


Additional command files’ may bé added at the system -* 


administrator's discretion. 


/dev The directory that contains all device files. A device 
file is a special type of empty file that associates the 
device type and its major and minor device numbers 
with the device name. Device files for devices which 
are not included on a given system may be deleted from 
the /dev cirectory. Occasionally new device files must 
be added. In this case the device name, ownership, 
and access privileges should be modeled after similar 
device files already contained in the /dev directory. 


Do not change the names of standard device files. If 
a new name is desired for a standard device, link it 
to the new device name instead of renaming it. 


/drive An empty file that was used during the update 
procedure to mount other devices. The system 
administrator should create other dummy files to be 
used for mounting (e.g. /a, /b, /stdl). 


/equ The directory /equ contains files that programmers 
will occasionally include into their programs. These 
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/ete 


/gen 


/tmp 


/usr 


files describe various aspects of the operating system. 
Their use is strongly recommended. Note that most 
of these files are also linked to the /usr/inelude 
directory. 


This directory contains a number of programs and data 
files that are required for system operation. Programs 
in the /ete directory are not intended to be used 
directly (as are the programs in the /bin directory). 


This directory contains the files required to generate 
anew cromix.sys file. 


This is an empty directory, available to all users. It 
should remain empty. Some user programs create 
temporary files in this directory. The temporary files 
should be deleted pricr to program termination. The 
system administrator should periodically delete the 
contents of the /tmp directory (while no user is 
running). 


The /usr directory contains a number of 
sub-directories. Some of these sub-directories belong 
to the system: 


help - On-line manual files (contain the ehip 
extension. 


‘inelude Default directory to contain #include files 


“used-by the C programming language.: © 


lib The directory intended to contain object 
libraries for different languages. 


mail Directory where mail is deposited until the 
user inspects it. 


pkg Directory used for installation of software 
packages. 
query Directory that contains data files for the 


query utility. 


spool The spool utility temporarily copies files 
to be printed to this directory. The printer 
daemon prints them. 


unix Files necessary to boot the UNIX operating 
sy stem. 


The remaining directories are intented to be home 
directories for users. As the system is distributed 
there are two home directories provided for userl and 
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user2,. 


The system administrator, and other privileged users, are strongly discouraged 


from scattering files throughout the system. Every user, privileged or not, 
should have a home directory in the /usr directory. This simplifies partial 
backup on a user-by-user basis. 


iB 
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Chapter 2 


INITIAL CROMIX SYSTEM START-UP 


This chapter describes how to start up the operating system for the first time, 
how to build and update the Cromix-Plus system on a hard disk, how to tailor 
the system to your particular needs, and how to create a boot diskette. For 
a ae, procedures you will need a set of Cromix-Plus release diskettes (5-1/4" 
or 8" 


Cromix-Plus release disks are write protected to prevent them from being 
accidently erased or overwritten. The 5-1/4" release disks should have a silver 
sticker on the upper right edge; 8" release disks should NOT have a silver 
sticker on the bottom edge. You can ignore the "Read only file system" 
messages issued by the mount, unmount, and updatel commands. However, 
when using the Mount command to list the mounted devices, the mount utility 
eannot know which devices are mounted because the mount table (the /ete/mnt 
file) cannot be written to - it is a write-protected root device. 


Use the system console (the terminal connected to J4 on the 64FDC/16FDC 
board) for all dialogue in the procedures that-follow (refer to chapters 4 and 
5 for hardware installation). User entries are in boldfaced ty pe, and all entries 

' must be terminated by pressing the RETURN key. : 


COLD BOOTING CROMIX-PLUS 


Cromix~Plus can be cold booted (started from power on or reset) from a variety 
of devices. A device containing the bootstrap program and the file /eromix.sys 
is required. The file /eromix.sys may be configured for a predefined root device 
cr it may prompt the operator to enter the device number which will be the root 
device. 


The root device may or may not be the same as the boot device. The root device 
must contain at least a minimal Cromix-Plus file system. 


If the system is in the original factory configuration, partition zero of the hard 
disk is set up to function as both boot device and root device. In this case the 
startup procedure is as described below. 


If the hard disk is not in the factory shipped configuration (contains an older 
version of Cromix-Plus, hard disk is empty, or the file system requires repairs), 
performing the update procedure (from floppy disk) described later in this 
chapter will be required before the following procedure will apply. 
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Turn on the system console and the system itself. If nothing happens in a few 
seconds, press the console RETURN key several times. If the system is set to 

- auto-boot (refer to XDOS description in appendix C), the following display 
should appear: 


XDOS version xx.yy 
Preparing to boot - type ESC to abort 


Address: Memory test by 16K blocks 
OOOOD00D +rttttttttttttttttt ttt tttttttt+ 


Co~processor test OK 

Standby 

Address: Memory test by 16K blocks 
OOOOOOKs +t ttttt ttt ttt ttt ttt ttt ttt 
Cromix~Plus Operating System version xx.yy 
Copyright (¢c) 1986 Cromemeo, Ine. 

Boot System 


System initialization complete 
PID = 7 


For information about this version of Cromix, ty pe the command "newuser". 


Cromix-Plus Operating System version xXyy 


The message from /etc/weleome: Welcome to Cromix-Plus Operating 
System . 


Login: - system - 
Logged in system mmm-dd-yyyy hh:mm:ss on ttyl 


Message of the day: Welcome to Cromix-Plus Operating System 
sy stem[{1] 


Two system memory tests were performed. The first by XDOS and the second 
by Cromix-Plus. 


The message: 
PID =7 


indicates that the flush utility was started as a detached process and that it 
has process ID number seven. 


Login as the privileged user "system" was performed automatically by 
Cromix-Plus. 


The last line ("sy stem[1 ]") is the Shell prompt. 


Cromix-Plus is now running and is ready to execute any command. 
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Note: Please note the version of the operating sy stem reported during system 
initialization and compare it to the version of the operating system 
written on the sy stem diskette labels. If the version written on the 
diskette labels is higher than the version displayed by Cromix-Plus, 
the hard disk must be updated from the floppy disks. Shutdown the 
system and follow the update procedure outlined later in this chapter. 


If the system is not set to auto-boot, the following prompt should appear: 


XDOS version xx.yy 


; 
Enter the XDOS command: 
sbst0 


The letter "b" invokes the XDOS boot command, the characters "st0" denote 
the boot device (STD hard disk partition 0). Following this command, the cold 
boot should proceed as described above. If the system does not boot, boot to 
a system floppy diskette and update the hard disk. 


It may happen that the system is configured to boot to the incorrect device. 
In this case, the boot procedure will not proceed to the. second memory test. 
It may halt prior to displaying: 


Standby 


In either case, reset the system and press ESCAPE in order: to abort the 
incorrect boot process. XDOS will revert to its prompt (";"). As in the above 
case, enter the command: 


;bst0 


If at any time, the hard disk cannot be successfully booted, follow the update 
procedure described in the following section. If the system was successfully 
booted to the hard disk, and the version on the hard disk matches that of the 
floppy disks, there is no need to update the system. 


UPDATING THE HARD DISK 


If the hard disk cannot be successfully booted, or if the system on the hard disk 
has an incorrect version number, the hard disk must be updated. — 


The first step in the update process is to boot release floppy disk #1. Insert 
floppy disk #1 and reset the system (typing RETURN a few times might be 
necessary). When the following display appears: 


XDOS version xxyy 
Preparing to boot - type ESC to abort 
Address: Memory test by 16K blocks 
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COOOOOOD +rttttttttettttttettttttett44tt 
Co-processor test OK 
Standby 


press the ESCAPE key before the word "Standby" is displayed. 

The XDOS prompt (";") should now be displayed. Enter the XDOS command: 
3ba (boot from device A). 

The following will now appear on the terminal: 


Preparing to boot - type ESC to abort 


Address: Memory test by 16K blocks 
OOODDOOD +++tttttettttttttttttttttttttttt 


Co-processor test OK 


Standby 
Address: Memory test by 16K blocks 
OOOOODS Ft tttttttttttttettttttttttttttt+ 


Floppy = 1, STDC = 
Enter major device number: 


The floppy disk will be the root device - ee * i followed by RETURN. The 
Peltowine will.be displayed: © 


fda = 0, fdb= 1, fde = 2, fdd= 3 
sfda = 4, sfdb = 5, sfdec = 6, fdd = 7 
dfda = 16, dfdb = 17, dfde = 18, dfdd = 19 
‘Enter minor root ‘device ‘number: © 
Enter: 
0 if drive A is an 8" floppy drive 
4 if drive A is an 5-1/4" floppy drive 
16 if drive A is an 8" PERSCI floppy drive 


The boot will proceed as described in the previous section with the following 
differ ences: 


- The error message: 
Read only file system 


will appear occasionally. It is caused by the system's inability to write 
to the write protected floppy. 


- A different /ete/startup.msg file will be displayed. Press 
CON TROL-@ to display more text. 


- The Shell prompt will be "#" instead of "system[1]". This is a result 
of the system's inability to write to the /ete/who file on the write 
protected diskette. 
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Execute the cheek command: 
# eheek std0 


This program will check for inconsistencies in the file structure on the hard disk. 
If the check utility reports ANY errors, do NOT proceed until they are repaired. 
The next section describes methods of correcting errors in the file structure. 
If check reports no errors, execute the command: 


# updatel std0 


The command will first rename a few files that which might have custom 
information. This will prevent them from being over-written. These files are: 


/ete/group 
/ete/iostartup.emd 
/ete/motd 
/ete/passwd 
/etc/startup.emd 
/ete/startup.msg 
/ete/termeaps 
/ete/ttys 
/ete/weleome 

__ fete/ee_env 
/gen/sy sdef 


Each cf these files will be renamed to the same filename with the extension .old 
added to it. Note: if updatel is executed again, prior to naming the .old 
extended names to their original names, the original files will be lost. - © e 


Updatel will next copy all the files from the floppy to the hard disk and 
execute the "boot" command. 


The sy stem will again prompt for the root device number. This time the response 
should be "6" for the major device number, and "0" for the minor device number. 
Booting will proceed as before terminating with with the appearance of the Shell 
prompt: 

sy stem[1 ] 


The system is now rooted on the hard disk. Note however that the system has 
been only partially updated. To complete the updating process: 


1. Insert the first relase disk marked as being in FTAR format (5 1/4 disk 
#3 and 8" disk #2) into drive A and type: 


sy stem[1] update2 fda (or sfda) 
2. Repeat this for every remaining FTAR floppy disk in order. 


3. Execute the command: 
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sy stem[1] wboot root 
to write the bootstrap program to the hard disk. 
4. Execute the command: 
system[1] shutdown 
to shut down the system 
_ The hard disk is now fully updated and booting should proceed as described in 
the previous section. See the Appendix C (XDOS) for instructions regarding 
setting up the system for automatie booting. 
REPAIRING THE FILE STRUCTURE ON THE HARD DISK 


The instructions in this section must be followed if the cheek utility, executed 
during the previous instructions, reported any errors. 


The system must be rooted on a device other than the file sy stem being repaired. 


On systems which use 5 1/4" disks, boot release floppy disk #2. On systems 
which use 8" disks, boot floppy disk #1. 


Execute. the readall utility: 

# readall -a std31 
to determine whether there are problems on the disk which must be repaired. 
If- the readall utility reports any errors, the disk must be at least partially 
initialized. Refer to the next section for instructions on repairing the disk. 
Do not return to this section until the readall utility reports no errors. 


Execute the commands: 


# deheeck -s std0 
# icheek -s std0 


If no errors are reported (see the descriptions of the deheek and icheck 
utilities in the Cromix-Plus User's Reference ManuaJ]) the file structure problems 
have been corrected. If the system uses 5-1/4" floppy disks, kill the system, 
boot release floppy #1 and return to the update procedure in the previous 
section. Systems using 8" floppies need not reboot. ; 
If any errors are reported, they must be corrected prior to updating. 
The error: 

Not a Cromix device 
is most likely caused by the absence of a file structure on the disk. If this is 
the case (be certain, since this step will destroy any pre-existing file system), 
create an empty file structure on the disk using the makfs utility: 
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# makfs std0 


For other errors, refer to the documentation on the deheck and icheck utilities 
in the Cromix-Plus User's Reference Manual. 


Often, the deletion of files which are corrupted, will fix file system problems. 
The deheek and icheck utilities usually report the inode numbers of the 
corrupted files. To determine the file names corresponding to those inode 
numbers, mount the hard disk: 


# mount std0 /drive 
and run the neheck utility. For example: 
# neheck -i 44,55 /drive 


will return the file names corresponding to inodes 44 and 55 on the hard disk. 
Delete the corrupted files, unmount the hard disk: 


# unmount std0 
and once again execute: 


# deheck -s std0 
# icheck -s std0 


Keep deleting files until ieheek and deheck report no errors. 


' REPAIRING THE HARD DISK | 


If the readall utility reports disk errors, the following procedure should be 
followed. Do not update a disk drive until all disk errors reported by readall 
are resolved. 


If the hard disk is uninitialized, the inithard utility should be used to initialize 
it. Please refer to the discussion of the inithard utility in the Cromix-Plus 
User's Reference Manua}]. Execute readall to confirm that the drive is error 
free. 


Things are more complicated with a hard disk with an existing file system that 
has a few badly written tracks. The problem should be fixed before using the 
hard disk. 


A track can be unreadable because the hard disk has developed a bad spot. Try 
to initialize the bad track using inithard. If readall canread it without error, 
it was probably a soft recording error which is now repaired. These errors can 
be caused by power interruptions while the disk was being written to. Consider 
the problem resolved, but note the cylinder number and the surface number of 
the offending track, If ever appears bad again, consider assigning an alternate 
track to it. 


If initializing the track does not resolve the problem, or if the same track was 
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found bad previously, it must be declared a bad track. Use the inithard utility 
to enter the offending track into the alternate track table and run readall again: 


# readall -a std31 


If errors persist or seem to be moving around, the hard disk and STDC controller 
should be examined for problems, 


When the readall utility no longer reports any errors, return to the previous 
section. 


Note: If a track is initialized (or declared bad) the file structure will most 
likely be damaged. The check utility will probably report a large 
number of errors. They must all be corrected. 


SYSTEM CUSTOMIZATION 


At this point the readall and cheek utilities report no errors and the update 
procedure (updatel and update2) has been completed. 


After making the following changes, reboot the system. The system should be 
fully operable. 


Store the release floppy disks in a safe place. They should only be required 
in the event of problems. 


System customization requires the editing of a few files. Knowledge of at least 
‘some rudimentary commands of the CE editor is required. Refer to the 
- Cromix-Plus User's Reference Manual. = oS 

The Term Variable 


To use the CE editor, the system must know what type of terminal is to be used 
and what capabilities it posesses. Entering the command: 


sy stem[1] term 
will display the terminal type. At this point it will indicate that term is set 
to dumb. The dumb terminal entry contains only minimum capabilities, fewer 
than required by CE. The terminal being used must contain an entry in the 
/ete/termeaps (terminal capabilities) file. This file may be examined using 
the more utility: 

system[1] more /ete/termeaps 


If an entry is found, it will also describe the name which the system uses to 
refer toit. This is the value which should be entered into the term variable. 


Cromemco terminals are listed as such: C-10, C-05, C-15 and 3102. 


Enter the command term followed by the terminal name SSE as in the 
termeaps file) For example: 
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sy stem[1] term C-10 
As part of this customization procedure, the terminal type should be entered 
into the /ete/ttys file. The terminal type will then always be available to the 
sy stem. 
Generating a New Operating System 
Make the directory /gen the current directory by executing the command: 
system[1] d /gen 
Create a copy of the sysdef file: 
sy stem[1] copy sysdef mysysdef 
and edit the copy: 
sy stem[1] ce mysysdef 
Add all the drivers required and delete the drivers not required. Adjust the 
system parameters. Consult the description of the sysdef file in the 
Cromix-Plus User's Reference Manual. When the sy sdef file has been suitably 
altered, execute the crogen utility:- 
sy stem[1] erogen cromix mysysdef 
A new version of cromix.sys. will on pone aed in the /gen cirectory, 
Prior to moving it to the root directory (/), test it by booting: 


system[1] boot cromix 


If the boot is successfull, move the new system to the root directory, 
overwriting the old one: 


system[1] move -fv /gen/cromix.sys / 


The /ete Directory 


The /ete dir ec tory contains a number of files which should be customized. The 
following is a list of files which should at least be considerd for customization. 
Note: If the updated hard disk contained a working file system, this directory 
may contain files with the .old extension. Use care in moving old files over new 
ones since their function may have changed since the previous version. Use the 
old files for comparison. 


Lostartup.cmd 


lostartup.cmd is the command file that will execute immediately after the 
system is booted. It is used only for downloading I/O processor boards. Do not 
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put other initialization commands into iostartup.emd. 


This file should be edited to remove comment signs (%) at the beginning of lines 
which should be activated. Note: Each STDC controller and IOP or Octart in 
the system MUST be downloaded. 


Itys 


The ttys file describes active terminals. If any lines are added or deleted, the 
system must be rebooted (do not issue the kill -1 1 command). Normally lines 
will simply be altered. 


Each line contains 5 fields which are separated by colons (:). The first field 
is: 


0 terminal disabled 
1 terminal enabled 


The second field contains the terminal baud rate. The ttyl terminal should 
contain an "n" in this field which represents "no change" (the baud rate was 
determined by XDOS). For other terminals this field can contain an "a" for 
"automatic" baud rate or one of the supported baud rates can be used (see the 
/equ/modeequ.h file) Automatic baud rate means the the user must type a 
RETURN a few times to establish the baud rate. 


The third field contains the device name of the terminal. The fourth field 
contains the terminal type. For hard-wired terminals, enter the correct terminal 
type. For modem terminals (mtty) this field should remain "dumb" as it is not 
possible . to determine what. type of terminal the user is going to have. | 


The fifth field contains the automatic login name. “The login name "sy stem" 
should probably be deleted from the ttyl terminal entry. 


Changes to the ttys file can be made effective by rebooting or executing the 
kill -1 1 command. The only change which can be made to active terminals is 
to make them inactive. If a terminal is inactive, the entire line can be changed 
and if the change enabled the terminal, the kill -1 1 command will make it 
active according to the new definitions. 


Do NOT enable terminals that do not exist. This is particularly important for 

- tty terminals connected to 64FDC and TUART boards which do not have current 
loop circuitry disabled. If such terminals are enabled, the gtty process will 
continually. use system time trying to determine whether anyone is pressing keys 
on those terminals. 


Pass wi 


The file /ete/passwd contains the list of users that are allowed to use the 
system and fields which describe: their encoded password (optional), user and 
group ID numbers, home directory, program to be executed upon login (opticnal) 
and user prompt (optional). This file can be viewed using the more utility. It 
should not be edited. The passwd file should be maintained vis the passwd 
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utility. 
Group 
The file /ete/group is similar to the passwd file, but contains information about 


groups. This file should be maintained via the group utility. Organizing users 
into groups helps make good use of the file protection system. 


Startup.cmd 


This file is automatically executed after system initialization is complete and 
prior to the login message being displayed. Any Cromix-Plus command can be 
included in this file. Use the existing startup.emd file as a template. Do not 
delete the flush command (periodically flushes system I/O buffers), but the time 
between flushes can be altered. Since the XXU contains a real-time clock with 
battery backup, system time should rarely require adjustment. 


Termecaps 


This file describes the operating characteristics of various terminals. Al] 
terminal types used on the system should contain an entry in /etce/termeaps. 
Refer to the discussion of termeaps in the Cromix-Plus User's Reference 
Manual. 


The contents of this file will be displayed on the system console as part of the 
boot procedure. The file can contain any text. 


Welcome 


The contents of this file will be displayed on every terminal BEFORE the user 
login prompt. It can contain any text. 


Motd 


The contents of this file will be displayed on every terminal AFTER the user 
has logged in. It can contain any text. 


Ce_env 


This file contains environmental information for the CE editor. Consult the 
Cromix-Plus User's Reference Manual for information. 
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Chapter 3 
CROMIX PERIPHERALS; SOFTWARE CHANGES 


This chapter describes the software changes required to add, or remove 
terminals, modems, and printers. Be sure to make the appropriate software 
changes in this chapter, and all hardware changes in chapters 4 and 5, before 
you re-boot the system; otherwise you may activate software changes that are 
incompatible with the on-line hardware. , 


SINGLE-USER VERSUS MULTIUSER SYSTEMS 


The system set up in chapter 2 is single-user because only one terminal is 
on-line (the system console connected to the floppy disk controller board), 
For a multiuser sy stem, install one terminal for each additional user. With the 
‘passwd utility, assign each user a name, password, user ‘identification number 
(UID), group identification number (GID), and a home directory (refer to the 
Cromix-Plus User's Reference Manual, part number 023-5013). 


One person can log in on several terminals at once, each time using the same 


- user name and password, because the -Cromix kernel associates not only a UID 
with each process, but a terminal number as well. 


CREATING DEVICE FILES 
The /dev directory on the factory shipped disks contains several device files 
for each device type. It may become necessary to create additional device files 
to support edditional hardware. 
To create a device, use the makdev utility: 

sy stem[1] makdev filename b/e majornum minornum 
The first argument is the name of the device file being created. 


The second argument should be: 


b for block devices 
e for character devices 


The third argument is the major device number. The /gen/sysdef file can 
associate any driver with any major device number, though it is strongly 
recommended that the conventions suggested in the sysdef file be adhered to. 
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Under Cromix-Plus, device I/O works as follows. I/O references are made to 
a device file. This device file has a device type and major device number 
associated with it. The major device number selects a device driver (software 
interface) as specified in the /gen/sysdef file. The driver knows the class of 
devices it must support. The actual device is selected by the minor device 
number. 


The minor device number (fourth makdev argument) specifies the actual device 
from the class of devices that the driver supports. Occasionally, the minor 
device number contains additional information. For example, the eflop driver 
for Cromemco style floppy disks can support four drives. There are however, 
12 minor device numbers available, with 12 device files. The minor device 
numbers 0, 1, 2 and 3 refer to the four possible floppy controller channels (A, 
B, C and D). If 4 is added to the minor device number, the physical device 
referred to is still the same, the addition of 4 denotes that the actual disk drive 
is a 5-1/4" drive instead of an 8" drive. If 16 is added to the minor device 
number, the driver will know that the drive is a PERSCI drivein which the heads 
of the paired drives move together. Some drivers require a list of minor device 
numbers in the sysdef file. If this is the case, only the listed minor device 
numbers will be supported. These numbers are described in the information 
section of sysdef. 


Once a device file is created, the chowner command should be used to change 
the owner of the device file to be bin: 


sy stem[1] chowner bin filename 
The access code should be changed with the access utility: 

sy stem[1] access access-string filename 
This will prevent unauthorized users access to the device file. See the 
description of the access utility in the Cromix-Plus User's Reference Manual. 
Model the access code after that of other similar devices. 
If a different name for an existing device file is required, do not rename it. Use 
the maklink utility to create another name for the same device. 


DESCRIPTION OF MINOR DEVICE NUMBERS 


Here is a list of devices which are likely to be added with system expansion. 


Qtty 
The qtty driver supports terminals on Octarts and I1OP/Quadarts. 


Octart 


bit # 


7 943210 
marker |m0oo6cuu 
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The bit denoted by "m" handles hangup signals: 


0 = do not generate hangup signals 
1 = generate hangup signal if the phone line breaks 


Modem terminals (mtty) must have this bit set. 
The bits marked by "o" indicate the octart number: 
00 = Cetart #1 
01 = Octart #2 


10 = Octart #3 
11 = Octart #4 


Be sure that /ete/iostartup.emd actually downloads all affected Octarts. 
The bit marked by "e" denotes the connector: 


= connector Jl 


0 
1 = connector J2 


The bits marked by "u" select the correct terminal on a special Octart cable 
that allows rour terminals to be plugged into an Octart connector. 


1OP/Quadart ~ 


bit # 176543210 
marker |mCiiqqee 


The bit marked by "m" handles hangup signal s: . 


use the even numbered connector 
use the odd numbered connector (modem) 


0 
1 
Modem terminals (mtty) must have this bit set. 


The bits marked by "i" denote the IOP number: 


00 = IOP #1 
01 = IOP #2 
10 = IOP #3 
11 = IOP #4 


The bits marked by "q" denote the Quadart number: 


= Quadart #1 
Q1 = Quadart #2 


11 = Quadart #4 
The bits marked by "e" denote the connector 
00 = connector J2 or J3 
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01 = connector J4 or J5 
10 = connector J6 or J7 
11 = connector J8 or J9 


Be sure that /ete/iostartup.emd actually downloads all affected IOP's. 


Slpt 


This driver supports serial printers on 64FDC and TUART boards. The minor 
device number is structured in binary as follows: 


bit# |76 
marker | p p 


543210 
uuuuuuU 
The bits marked by "p"™ denote the communications protocol: 
00 = XON/XOFF protocol 
01 = CLQ ty.pe printer (needs special cable) 
10 = ETX/ACK protocol 
11 = Not used 
The bits marked by "u" denote the unit number. The values supported are: 
0, 6, 7, 8, 9, 10, and 11 


The sysdef file must list all minor device numbers to be used. 


Qslpt 


The qsipt driver supports serial printers on IOP/Quadarts and on Octerts. 


The bits marked by "p" denote the protocol: 


00 = XON/XOFF protocol 


‘01 = Not used 
10 = ETX/ACK protocol 
11 = Not used 


The bits marked by "o" denote the octart number: 


00 = Cetart #1 
01 = Octart #2 
10 = Cetart #3 
11 = Octart #4 
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The bit marked by "e" denotes the connector: 


0 
1 


eonnector Jl 
connector J2 


The bits marked by "u" select the correct terminal on a special Octart cable 
that allows four terminals to be attached to an OCctart connector. 


Be sure that /etce/iostartup.emd actually downloads all affected Octarts. 
JOP/Quadart 


bit # 176543210 
marker |ppiiqqee 


The bits marked by "p" denote the protocol:. 


= XON/XOFF protocol 
= Not used 
= HTX/ACK protocol 


0 
0 
1 
11 = Not used 


0 
1 
0 
1 


The bits marked by "i" denote the IOP number: 


The bits marked by "q" denote the Quadart number: 


00 = Quadart #1 
01 = Quadart #2 
10 = Quadart #3 
11 = Quadart #4 


The bits marked by "e" denote the connector: 


00 = connector J2 or J3 
01 = connector J4 or J5 
10 = connector J6 or J7 : 
11 = connector J8 or J9 


Be sure that /ete/iostartup.emd actually downloads all affected 10P's. 


Uflop 


The uflop driver supports uniform style floppies. Uniform style floppies are 
UNIX compatible. All tracks on the disk are recorded in the same manner (no 
boot track). There is no disk label to tell how the disk is recorded. All this 
information must come from the minor device number. The minor device numbers 
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for the uflop driver are structured in binary as follows: 


bit # 176543210 
marker |0 xydzsuu 


The bit marked by "x" denotes the density: 


0 = double density 
1 = single density 


The bit marked by "y" denotes the number of sides: 


double sided 
single sided 


1 
The bit marked by "d" denotes PERSCI type drives: 


single drives 
drives move heads in pairs (PERSCI) 


HoT 


0 
1 
The bit marked by "z" selects track density: 


single tracked 


0 
1°= double tracked (not supported) 


Hou 


The bit marked by "s" denotes the size: 


0 
1 


gn 
5-1/4" 


The bits marked by "u" denote the unit number: 


00 = drive A 
01 = drive B 
10 = drive C 
11 = drive D 


Tflop 


The tflop driver supports floppy tapes. A floppy tape can be connected to the 
64FDC controiler in place of two floppies (A-B or C-D). The minor device 
number is structured in binary as follows: 

bit # 176543210 

marker |0000fduu 


The bit marked by "f" denotes the way the tape is initialized: 


0 
1 


252 segments per stream 
255 segments per stream (Cannot be initialized 
on Cromemco hardware) 
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The bit marked by "d" denotes the drive: 


0 = 
l= 


drive AB 
drive CD 


The bits marked by "u" denote stream selection: 


00 = All six streams 
01 = streams 0 and 1 only 


10 
ll = 
Stde 
An STUIC hard 


= streams 2 and 3 only 
streams 4 and 5 only 


disk can contain up to 31 partitions numbered 0... 30. Partition 


31 refers to the entire disk. 


The minor device number is structured in binary as follows: 


The bits marked by "e" denote the controller number: 


00 
01 
10 
“il 


= controller #1 
= controller #2 
= controller #3 
= controller #4 


The bit marked by "d" denotes the drive number: 


The bits marked by "p" denote the partition number (0 .. 31), 


If more than one controller is being used: 


Smid 


SMD hard disk 


include it in the sysdef file 

connect all controllers via the DMA chain 

ensure that IC37 on the higher priority STDC board is part number 
902-0086-2 or higher 

ensure that /ete/iostartup.emd downloads all controllers 


s have the minor device number structured in binary as follows: 
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0 = Controller #1 
1 = Controller #2 


The bit marked by "d" denotes the drive number: 


0 = drive #0 
1 = drive #1 


The bit marked by "r" denotes the removable part: 


fixed part 


0 
1 = removable part 


The bits marked by "b" denote the beginning head number (0... 31). 


FINAL HINTS 


A few trouble shooting hints: 


Install boards before modifying any files. 
Carefully include drivers in the sysdef file. 
Edit the /ete/iostartup.emd file to download all boards. 
Create any necessary device files. 
Generate a new /cromix.sys. 
Reboot the system. 
Test the new boards with non-destructive commands, e.g. mode. 
When installing a new terminal, try it off line initially. For example: 

sy stem[1] mode new_terminal 

system[2] mode new_terminal baud 9600 

sy stem[3 echo Hello > /dev/new_terminal 
If the terminal seems to work, and it is intended to be used as a login 
terminal, the /ete/ttys file must be modified. If an entry for the new 
terminal already exists (disabled), enable it and excute the kill -1 1 
command. If the /ete/ttys file does not contain an entry for the new 
terminal, add a new line to it with the terminal still disabled and reboot the 


system. Enable the terminal and execute the kill -1 1 command. 


NEVER delete or add a line to the /ete/ttys file without rebooting the 
sy stem. 
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Chapter 4 


INSTALLING TERMINALS, PRINTERS, AND MODEMS 


This chapter describes how to install and test terminals, printers, and modems 
on a Cromix-Plus system. The I/O interface boards that control these 
peripherals are discussed in chapter 5. 


TERMINALS 


All terminals used in Cromix systems must exchange ASCII-coded characters, 
use RS-232C interface circuits (not 20-mA current loop), and have a DB-25 plug 
on one end of the terminal cable. To use the C-10 computer as a terminal, refer 


to the Cromemco C-10 Personal Computer User Manual, part number 023-6037. 

Configure each terminal as follows: . 

1. Set the baud rate to 110, 300, 600, 1200, 2400, 4800, 9600, 19200, or 38400, 
depending on the I/O board used to control the terminal. The maximum 
baud rates are as follows: 


I/O Board’ Max. Baud’ Rate 


OCTART 38,400 
QUA DART 19,200 
TU-ART 19,200 
64FDC 9,600 
16FDC 9,600 


The baud rate must also be set in the /ete/ttys file, as described in 
chapter 3. 


26 Use two stop bits for 110 baud; otherwise, use one stop bit. 
3. Full duplex operation. 
4, Seven data bits per character, excluding the parity bit. 


5. Either space or mark parity (parity bit is reset to logic 0, or set to logic 
1, respectively). 


6. RETURN as the line termination character. 


7. No automatic linefeeds. 
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The MAIN port on most terminals is wired DTE-style, and the AUX port is wired 
DCE-style (with possibly a fixed baud rate), Install a terminal cable from the 
MAIN port of each terminal to a DB-25 connector on the system rear panel. 
Each rear panel connector must be linked internally to the appropriate interface 
board (refer to the section "I/O Interface Boards" in chapter 5), 


The System Console 


The system console, the terminal from which you boot the system, is initially 
connected to the 64FDC/16FDC board. Install the terminal cable from the MAIN 
port on the system console to the factory -installed rear panel connector coming 
from J4 on the 64FDC/16FDC board. Set the system console to 9600 baud. 


SERIAL PRINTERS 


All serial printers exchange ASCII-coded characters; have an RS-232C 
interface, and have a DB-25 plug on one end of the printer cable. Configure 
each serial printer as follows: 


1. Set the baud rate on a printer as you would for a terminal (refer to the 
previous section), but. check the manufacturer's documentation to avoid 
exceeding the maximum rate of the printer. The baud rate must also be 
set with the Mode utility, as described in chapter 3 (the ete/ttys file is 
used only for terminals and modems). 


2., Use two stop bits for 110 baud; otherwise, use one stop bit. 
3. Seven data bits per character, excluding the parity bit. 


4. Either space or mark parity (parity bit is reset to logic 0, or set to logic 
1, respectively). : 


De No automatic linefeeds. 


6. When operating above 300 baud, use either the DC1/DC3 or ETX/ACK 
protocol. If the data rate is 110 or 300 baud, the serial printer character 
buffer should never overrun, and no start/stop transmit protocol is 
required. 


7. Circuit DTR (pin 20) strapped ON (spacing high). 


8. If the printer has the TOF (Top Of Form) feature, add 
mode device-name -ff to file /etec/startup.emd; if the printer does 
not have the TOF feature, add mode device-name ff to file 
/ete/startup.emd (refer to the section "Startup.emd and lostartup.emd" 
in chapter 3). 
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If your printer monitors the CTS (Clear To Send) circuit, install the 
transmit jumper between CTS and RTS (figure 4-1), Keeping CTS true 
allows the printer to send DC1 or ACK characters back to the Cromix 
driver. If the printer does not drive RTS high, strap CTS high by some 
other means. If the printer does not monitor circuit CTS, the transmit 
jumper is not needed. 


If your printer monitors circuits DCD (Data Carrier Detect) and/or DSR 
(Data Set Ready), install the receive jumper between DCD, DSR, and DTR 
(figure 4-1). Keeping DCD and DSR true allows the printer to receive 
characters from the Cromix driver. If the printer does not drive DTR high, ~ 
strap DCD and DSR high by some other means. If the printer does not 
monitor either DCD or DSR, the receive jumper is not needed. 


Connect the cable from each printer to a DB-25 connector on the system rear 
panel. Each rear panel connector must be linked internally to the appropriate 
interface board (refer to the section "I/O Interface Boards" in chapter 5). 


Serial 
Printer 


| Transmit 
| Jumper bi 5 


I 

Receive | | 
umper 

| L120 


Figure 4-1: SERIAL PRINTER CABLE JUMPERS 
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PARALLEL PRINTERS 


All parallel printers must be Centronics-compatible, and have a DB-25 
connector on one end of the printer cable. Connect the cable from each printer 
to a DB-25 connector on the system rear panel. Each rear panel connector must 
be linked internally to the appropriate interface board (refer to the section "I/O 
Interface Boards" in chapter 5). 


Note: When using a PRI board, cables from other vendors may not connect pin 
15 on the PRI to pin 10 on the Cromemco model 3703 and 3715 dot matrix 
printers. 


MODEMS 


Quadart 


Any asynchronous modem may be used (such as Bell type 103J, 113C, or 212A), 

provided that the modems at both ends of the link are compatible. Configure 

the modem per the manufacturer's documentation, and plug the modem cable into 

a connector on the system rear panel. The rear panel connector must be linked 
‘internally to J3, J5, J7, or J9 on the QUADART board. 


The following RS-232C circuits are active on the QUADART DCE connectors (J3, 
J5, J7, and J9): TxD (circuit BA) pin 2, RxD (BB) pin 3, RTS (CA) pin 4, CTS 
(CB) pin 5, DSR (CC) pin 6, S-100 Bus Ground (AB) pin 7, DCD (CF) pin 8, TxC 


(DB). pin 15,.RxC (DD) pin 17, DTR (CD) pin 20, RI (CE) pin 22, and EXT CK . . 


(DA) pin 24. These connectors also support a special-purpose RS-232C level 
output line, CY pin 11. 


If mode attrioute sighup is on, and the remote modem hangs up, or if either Data 
Carrier Detect (DCD) or Clear To Send (CTS) are lost before a user hangs up, 
then a kill signal is sent to all processes started by the user, and the user is 
automatically logged off. If sighup is on and the user logs off normally, circuit 
DTR is briefly turned off, then turned back on (this hangs up the modem on the 
Cromix system end, and permits another user to phonein) Strapping DTR high, 
as allowed by some modems, prevents the driver from hanging up the modem. 


Octart 


At present, the OCTART board can support an intelligent modem under the 
following conditions (no device name is required): 


1. The modem-to-OCTART cable (Cromemeo part CBL-HAYES P/N 519-0249) 
must be wired as shown in figure 4-2. 


2. For the Hayes Smartmodem 1200 (and other compatible modems), the user 
must change configuration switches 1 and 6 to the UP (OFF) position to 
enable pins 8 and 20; the remaining switches should be in the DOWN (ON) 
position. 
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Figure 4-2: MODEM-~TO-OCTART CABLE CONNECTION 


TESTING PERIPHERAL HARDWARE 


If a peripheral does not respond correctly, check the following items (refer to 
chapters 3 and 5 as necessary): 


1. Remove the boot disk and turn off system power. Check all switch 
settings, jumper options, and cable connections. Be sure that the red cable 
stripe on all ribbon cables is properly aligned. Be sure that each device 
is attached to the right connector on the right board (refer to appendix 
A). If the system does not boot properly, be sure the system console is 
connected to J4 on the 64FDC/16FDC. If the system detects an error 
before the drivers are loaded, the diagnostic message is sent only to the 
64FDC/16FDC port. 
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For terminals, check all /ete/ttys entries for accuracy. Make sure that 
a fixed baud rate is specified for the system console (9600 baud maximum 
for tty's, 19200 for qtty's). If necessary, modify the file with the Screen 
utility, and enter the command: 


# kill -1 #1 


to incorporate the change. 


Verify that the appropriate device file exists in the /dev directory. If 
not, create one with the Makdev utility. 


Check that the system console and system printer are linked to the correct 
devices for your system. 


Verify that the device driver is included in the cromix.sys program by 
entering the command (device ttyl used as an example); 


# mode /dev/ttyl 


If a message reports that there is no device driver, you must generate a 
new cromix.sys program (refer to chapter 3), and reboot the system. 


If a device driver is present, the operating modes for the device are 
displayed. Compare them.to the modes selected on the device itself for | 
possible conflicts. If a conflict exists, eorrect it by changing the options 
on the device, or by changing the Mode command in the /ete/startup.cmd 
file. 


If your system has QUADART or OCTART boards, verify that the percent 
sign has been removed from the appropriate command line(s) in the 
/ete/iostartup.emd file. If necessary, use the Screen utility to correct 
the file, and reboot the system. 


If the problem persists, contact your local Cromemco dealer, distributor, or 
authorized service facility. 
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Chapter 5 


INSTALLING CIRCUIT BOARDS 


This chapter describes the cables, switch settings, and jumper-selectable 
options for all of the Cromemco circuit boards used in standard Cromix-Plus 
sy stems. 


Refer to your system manual for details on accessing the system card cage, 
securing connectors to the rear panel, and so on. For more information on a 
particular board, refer to the appropriate board manual listed in the 
introduction. 


The XXU 
The XXU board has no switches to set. 


Insert the XXU in any slot in the system card cage. If the system contains an 
-XMU, install a 34-conductor cable (part number 519-0062) from the XXU to the 
XMM board (with the red cable stripe to the left). 


dumper Selectable Options 

The XXU board has three jumper locations as shown in Figure 1-1. Jumper JP1 
selects the clock source for the MC68881 coprocessor. As shipped, the MC68881 
clock input is the same 16.7 MHz signal used by the MC68020. When available, 
a higher speed coprocessor can be used by cutting the trace between pads 2 and 
3 of JP1 and installing a jumper between pads 1 and 2. Then install the 


auxiliary oscillator at location IC23 and replace the 16.7 MHz MC68881 with 
the higher speed version. 


Jumpers _JP2 and JP3 are for test purposes only and should be left open. 


Variable Capacitor Adjustment 


C2 is a variable capacitor for adjusting the accuracy of the real-time clock. 
If an adjustment is necessary, locate the arrow on the adjusting screw of C2. 
To slow down the clock, turn the screw so that the arrow is moved closer to the 
maximum capacitance position (arrow pointing toward the battery). To speed 
up the clock, turn the arrow away from the battery. Move the screw only a small 
amount, approximately a tenth of a turn at a time. Wait at least several hours 
to see if additional adjustment is necessary. 
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Figure 5-1: THE XXU BOARD 
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MEMORY BOARDS 


There are four memory boards to choose from: the 2048MSU (2 megabytes of 
RAM), the 512MSU (512 Kbytes of RAM), the 1024KZ (1 megabyte of RAM), and 
the 256KZ (256 Kbytes of RAM). All are compatible with both the Cromix-Plus 
and UNIX System V Operating Systems. The 2048MSU and 512MSU are used in 
conjunction with an MCUX board to provide error detection and correction. 


The MCUX 

An MCUX controls up to six MSU boards (any combination). There are no switch 
settings or jumpers to change unless you have more than one MCUX board. For 
multiple MCUX's, set the I/O port address jumpers as shown in figure 5-2 (the 
jumpers may be on either side of the board). 


The 2048MSU 


Set tiie 2048MSU switches as shown in figure 5-3. 


The 512MSU 

Set. the 512MSU switches as shown in figure 5-4. There are no jumpers to install. 
A revision B 512MSU board with mod level 2 (or higher) is required. - 

The M-Bus Cable 

Insert the MCUX’ and MSU boards ‘in adjacent slots of the system card cage. 
Install an M-bus cable (part number 519-0162 for one MSU, 519-0150 for two 
MSU's, or 519-0149 for three or four MSU's) from J1 on the MCUX board to Jl 
on the 2048MSU/512MSU (with the red cable stripe to the left). Always attach 
the first cable connector to the MCUX board. 

The 1024KZ 


The 1024KZ board has no jumpers to set or cables. To install the board, set 
the 1024KZ switches as shown in figure 5-5. 
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Figure 5-6: 256KZ SWITCH SETTINGS 
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The 256KZ 


The 256KZ board has no jumpers to set, and no cables to install. Set the 256KZ 
switches as shown in figure 5-6. The PROM at IC39 must be removed from all 
but the first board. 


Floppy Disk Controller Board 
The 64FDC-X 


The standard 64FDC switch settings (see figure 5-7) configure the board as 
follows: 


1. Switch 1 OFF allows XDOS to adjust the serial channel (after receiving 
a few RETURN characters) to the baud rate of the system console (attached © 
to J4 on the 64FDC). If switch 1 is ON, the baud rate is preset to 9600 
baud. 


Ze Switches 2, 3, 4 and 5 are used to select the automatic boot device 
according to the next table. 


_ The four jumper-selectable options above SW1 (figure 5-7) are factory-set, and 
should not be changed. : 


82 83 84 85 


STD31 OFF OFF OFF OFF 
STD63 OFF OFF ON OFF 


‘STbU ON ‘OFF OFF =ON 
STDL ON OFF ON ON 
STD2 ON ON OFF ON 
STD3 ON ON ON ON 


STD32 ON OFF OFF OFF 
STD33 ON OFF ON OFF 
STD34 ON ON . OFF OFF 
STD35 ON ON ON OFF 
FLOP A OFF OFF OFF ON 
FLOP B OFF OFF ON ON 
FLOP C OFF ON OFF ON 
FLOP D OFF ON ON ON 
SPECIAL OFF ON OFF OFF 
ALTERN OFF ON ON OFF 


45 


Cromemco Cromix-Plus System Administrator's Guide 
5. Installing Circuit Boards 


Connectors 


~~ 
we 
Nes 
te] 
ry 
a 


Sebz¢ 
2231 ee 
§ £83 OCR 
4 vOS Ir Z¢ 
nn $201 
CHDK 5u CE .. Et BG 


re 
‘o 
“y, 


A Ags: @ a 3. 
N ow 
é eet 2 

al Fleas 
RF ial = it) 4 

(2 
Lf 
a 
‘ 


oO 
ce 
reas} 


wm 
°° 
a 


DIED 12 
" ‘ 


dass 
RL 
af 
aS 
a 
nh 
o 
4 


g 
AS 
uw 
a 
7 
oc) 


@roT,  maeaeC 
2vol ,2OSIT 


[eestvze 
a > 
Ele 


fs 
Seder ST sr 
it 
€} 
° 


‘Cs e" 


a rs 2 
6B1SZ e PBS Ize 
“SND Dueck af F861 Do 


5 
a 
7 
Fy 
ar} 


pas iwZe 


BIS SN 


‘ Comp Gap 
574 
aH 
a a 
a eal 
2 i wat 
iy Tt 
< St) ep * ne : a * 
2 Bas STNEY SD, 
Base Ze 
Gib 8y3, 
GIS Ze Be 
Ef) qe aso 
aL aaariae 


i 


Figure 5-7: 64FDC SWITCHES AND JUMPERS 
The 64FDC Cables 


A 26-conductor cable (part number 519-0086 on CS1 & CS100; 519-0017 on CS2; 
519-0008 on CS3 & CS300) is factory installed from J4 on the 64FDC (with the -- 
red cable stripe on the left) to a rear panel connector slot. The system console 
plugs into the connector on the rear panel coming from J4 on the 64FDC. 


On standard configurations, either a 50-conductor cable (part number 519-0135) 
is installed from J3 to the 8" floppy disk drive(s), or a 34-conductor cable (part 

number 519-0106 on CS1; 519-0121 on CS1H; 519-0018 on CS2) is installed from 
J2 to the 5-1/4" floppy disk drive(s). 


Connect the priority interrupt cable to Ji on the 64FDC (refer to the last 
section of this chapter). 
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HARD DISK CONTROLLER 
The STDC 


The STDC hard disk controller board (figure 5-8) uses an ST-506 standard 
interface to support a wide variety of hard disk drives. The STDC firmwere ROM 
(IC26) should be part number 502-0106-5 or higher. The address jumpers A7 
through A2 (jumper area D) should be set according to the diagram in figure 5-8. 
When shipped the boards are set for controller 1. 


Install a 34-conductor cable (part number 519-0191 on CS1 and CS100; 519-0193 
on C82; 519-0195 on CS3 and CS300) from J1 on the STDC (with the red cable 
stripe on the left) to the edge connector on the drive. If you have two hard 
disks, install a dual-drive control cable (part number 519-0225). Install a 
20-conductor cable (part number 519-0190 on CS1 and CS100; 519-0192 on CS2; 
519-0194 on CS3 and CS300) from J5 on the STDC to the edge connector on the 
drive. If you have two hard disk drives, install another data cable from J4 on 
the STDC to the second hard disk. 


Connect the priority interrupt cable to J2 on the STDC (refer to the last section 
of this chapter). 


Connect the DMA priority cable to J3, (only required if more than one controller 
is used). 


1/O INTERFACE BOARDS 


Cromemco makes several I/O interfacé ‘boards: OCTART, IOP, Q@UADART, 
TU-ART, anc PRI. These boards support modems, terminals, and printers. The 
QUADART is always:used in conjunction with an IOP board. 


The OCTART 


Up to four CCTART boards can be installed in a single system, and one OCTART 
supports up to eight terminals or serial printers (in any combination). 


If you change the standard ROM (IC10) to one with an access time of 150 nSee 
or less, cut the trace shown in figure 5-9. The OCTART switch settings are 
shown in figure 5-10. When using OCTART and IOP boards in the same system, 
each board must have a different base port address (compare figures 5-10 and 
5-11). , 


Insert the OCTART into any slot of the system ecard cage. Install two 
26-conductor cables (part number 519-0086 on CS1 & CS100; 519-0017 on CS2; 
519-0008 on CS3 & CS300) from OCTART connectors J1 and J2 to any of the rear 
panel connector slots. Mark the rear panel to identify the OCTART connectors. 
To support the full eight terminals or serial printers, plug an OCTART cable 
(part number 519-0184) into both rear panel connectors, and connect four device 
cables to each OCTART cable. Without the OCTART cable, you can support two 
devices (qtty1 and qtty5) by plugging their cables directly into the two rear 
panel connectors. 
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Connect the priority interrupt cable to J3 (refer to the last section of this 
chapter). 
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The IOP 


Up to four IOP boards can be installed in a single system, and each IOP controls 
up to four QUADART boards. Be sure that the ROM in IC9, which holds the IOP 
monitor program (IOPMON), is labeled version 03.00 or higher. Set the IOP 
switches as shown in figure 5-11. When using OCTART and IOP boards in the 
same system, each board must have a different base port address (compare 
figures 5-10 and 5-11). 


Insert the IOP in the card cage with at least one empty slot adjacent to it. 
Install a 2-connector C-bus cable (part number 519-0100) from Jl on the IOP 
(with the red cable stripe on the left) to the 50-pin connector on the QUADART. 
If you have two QUADART boards, use the 3-connector cable (part number 
519-0181); if you have three or four QUADART boards, use the 5-connector cable 
(part number 519-0101). Always attach the first cable connector to the IOP 
board. 


Connect the priority interrupt cable to J2 on the IOP (refer to the last section 
of this chapter). 


The QUADART 


_ Up to sixteen QUADART boards can-be installed in a single system (four 
QUA DART's for each IOP), and each QUADART supports up to four modems, -— 
terminals or serial printers (in any combination). 


Set the QUADART switches as shown in figure 5<12. If you have multiple 
QUADART boards, change the jumpers on the plug in IC28 (see figure 5-12), 
‘For QUADART 1, 5, 9, and 13, the plug is correct. as shipped; for QUADART 4, - 
8, 12, and 16, the plug must be removed. 


Insert up to four QUADART boards in successive card slots next to each IOP 
board, and install the C-bus cable from J1 on the IOP (with the red cable stripe 
on the left) to J10 on each QUADART. Always attach the first cable connector 
to the IOP board. If you have four QUADART's controlled by one IOP, install 
a C-bus priority cable (part number 519-0029) from Jl on QUADART 3, 7, 11 
or 15 to J1 on QUADART 4, 8, 12 or 16, respectively (see figure 5-12). 


Install up to four 26-conductor cables (part number 519-0086 on CS1 & CS100; 
519-0017 on CS2; 519-0008 on CS3 & CS300) from QUADART connectors J2 
through J9 to any of the rear-panel connector slots. Plug the terminals or 
serial printers into the rear panel connectors coming from J2, J4, J6, and J8; 
plug any modems into connectors from J3, J5, J7, and J9. If you use J2, you 
cannot use J3 (and vice-versa); if you use J4, you cannot use J5, and so on. 
Mark the rear panel to indicate the device associated with each connector (refer 
to appendix A), 
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Connectors Base 1/0 
J2  J4 J6 J8 Port Address 


J3 J5 J7 J9 
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Quadart #1,5,9,&13 
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Figure 5-12: QUADART SWITCHES AND JUMPERS 
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The TU-ART 


Up to three TU-ART boards can be installed in a single system, and each 
TU-ART supports two terminals, and two Centronics-style parallel printers. 
Set the TU-ART switches as shown in figure 5-13. 


Insert the TU-ART into any slot in the system card cage, and install up to four 
26-conductor cables (part number 519-0086 on CS1 & CS100; 519-0017 on CS2; 
519-0008 on CS3 & CS300) from connectors J2 through J5 on the TU-ART board 
(with the red cable stripe on the left) to any of the rear panel connector slots. 
Plug the parajle] printer cables into the rear panel connectors coming from J2 
or J3 on the TU-ART; plug the terminal cables into the rear panel connectors 
coming from J4 or J5. Mark the rear panel to indicate the device associated with 
each connector (refer to appendix A). 


Connect the priority interrupt cable to J1 on the TU-ART (refer to the last 
section of this chapter). 


The PRI 


Two PRI boards can be installed in a single system, and each PRI supports one 
dot matrix printer and one typewriter printer (both Centronics-style parallel 
devices). Set the PRI switches and jumpers as shown in figure 5-14. When using 
a TU-ART and a PRI together, assign a different address to each board (compare 
figures 5-13 and 5-14), 


Insert the PRI into any ecard slot in the system card cage, and install two 
26-conductor cables (part number 519-0086 on CSi & CS100; 519-0017 on CS2; 


519-0008 on CS3 & CS300) from connectors J1 and J2 on the PRI board (with * 


the red cable stripe on the left) to any of the rear panel connector slots. The 
dot matrix printer cable plugs into the rear panel connector coming from J1 on 
the PRI; the typewriter printer cable plugs into the rear panel connector coming 
from J2. Mark the rear panel to indicate the device associated with each 
connector (refer to appendix A). 


Connect the priority interrupt cable to J3 on the PRI (refer to the next section). 


34 


Cromemco Cromix-Plus System Administrator's Guide 


5. Installing Circuit Boards 


TUART #1 
Channel A, 60h 


Channel B, 70h 


Connectors 


,» 80h 
, 90h 


TUART #2 
Channel A 
Channe! B 


ANEMracsoers | ICZTIG SIE: BlCAe TeHIP 


—c—, 


Lae eee 


alia Lae 


TUART #3 
Channel A, AOh 
Channel B, BOh 


am 
——S 


ie 4 
rs Th por tasee 
see ich A 
omes> a ou 


Bea ee 


ART SWITCH SETTINGS 


igure 5-13: TU- 


F 


99 


Cromemeo Cromix-Plus System Administrator's Guide 
5. Installing Circuit Boards 


Solder Side 
Solder Side 
ies Cut All Traces ft 


PRI #1 (50h) 
PRI #2 (60h) 


o ® 
2 3 
7) ” 
het oe 

c 
& 3 
= ce 
° re) 
a a 
€ = 
° =) 
(s) oO 


iro oss 
coir ao 
[rovasenane: WOR feng RB 
— 4e—. oo 


ST aggpoe, Socrates 


Brow Ate si 
mxoten ote 


HIER elena 


$ a : Keren: : SR 8 


ek I 7aasars se isisdeR 7 ‘gabe: 
‘abe 

CES ~, 3 ; 
“hea reqvary Jigseesins “cas Ne £1. nan ngee: ising eas Aan: 
= pesca 


zr 
“ier oy Kergvowe gg “iggy Elcieirmnin one ga reasons. 
3 


“ee mui * seas mies ‘aghast 


‘De? 
a 


er erse 
oy 


POR 34 SOT: GAIA OF: ATAIGS 
1 CART BRS, 


2 HOME ROD OF 9179 
DANERUPS 2e 


mney 
KRM eam cer Ggaesge SEUSS Mic: eggs 


Fi 
i 
gq 


Connectors 


sen She ae 
p ON I 
a Bad 
com hE 


Fi 
tar ne icy cos “ere muse 


rn 
cus 
ue 
GCM St 
PRI" 


ue 


Cacerenee a 

PRI“ i 
. 

avers * 


Figure 5-14: PRI SWITCHES AND JUMPERS 


56 


Cromemeo Cromix-Plus System Administrator's Guide 
5. Installing Circuit Boards 


THE PRIORITY INTERRUPT CABLE 


The 6-connector priority interrupt cable (part number 519-0029) determines 
the order in which the host processor services conflicting interrupt requests. 
Attach the first connector to Jl on the 64FDC/16FDC board by aligning the blue 
dot on the connector with the blue dot on the plug (figure 5-15). Align the 
yellow dots on the remaining plugs and connectors, and attach the second 
connector to the next highest priority board, the third connector to the next 
highest, and so on. 


The suggested order of board priorities is: 64FDC/16FDC, OCTART, TU-ART, 
IOP, BIART, GPIB, CTI, PRI, and STDC. The IN pin of the highest priority board 
(the 64FDC/16FDC) is not connected, nor is the OUT pin of the lowest priority 
board (the last board in the chain). The order of the boards is not critical, as 
long as the 64FDC/16FDC is first and the STDC is last. No boards or connectors 
should be skipped, and any unused connectors must be at the end of the cable 
farthest from the 64FDC/16FDC. Do NOT connect the priority cable to the 
WDI-II or Maximizer boards. 


If the priority connectors are not color coded, install the cable so that the OUT 
pin of the higher priority board is linked to the IN pin of the next highest board 
(the IN pin is on the right on all boards except 64FDC/16FDC, revision C of the 
STDC, and CTI). 


DMA PRIORITY CABLE 


The DMA priority cable (part number 519-0029) determines the order in which: 
boards requesting DMA at the same time actually gain control of the bus. If 
tiultiple STDC's are used, this cable must be attached to connector:-J3 on each 
board. The order of boards is not important as long as the cable is connected 
from the OUT pin of the higher priority board the IN pin of the next lower 
priority board. All boards must have a new IC37 (part number 502-0086-2 or 
higher) to be used any where in the chain other than as th lowest priority board. 
REV. C STDC boards cannot be used anywhere but the lowest priority board. 
Connector J3 on Rev. C STDC boards only has two pins while Rev. D STDC 
boards use a three pin connector. On the three pin connectors, connect the 
priority cable to the two pins closest to connector J2. 
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To Next Priority Board 


Figure 5-15: INSTALLING THE PRIORITY CABLE 
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This appendix lists all the device files that may appear in the /dev directory. 
Each entry consists of a device name, the type of board or boards that control 
the physical device, the board's jumper- or switch-assigned base I/O port 
address (e.g., OCTART #1 @ CEh means OCTART board number 1 with a base 1/O 
port address of CEh), the major:minor device numbers assigned to the device, 
and the board connector where the physical device is attached. 


Appendix A 


DEVICE FILE DEFINITIONS 


devices appear first, followed by the character devices. 


BLOCK DEVICE FILES 


System Block Devices 


Device 
Name 


root 
amem 


Board Ty pe 
@-Base Port 


System RAM 


8" Floppy Disk Drives 


Device 
Name 


fda 
fdb 
fde 
fdd 


8" Persei Drives 


Device 
Name 


dfda 
dfdb 
dfde 
dfdd 


Board Type 
@ Base Port | 


64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 


Board Type(s) 
@ Base Port 


16FDC @ 00h 
16FDC @ 00h 
16FDC @ 00h 
16FDC @ 00h 


09 


Device Number 

Major:Minor 
gos 

20 


0 
3 


Device Number 
Major:Minor 


Device Number 
Major:Minor 


Board 
Connector 


Board 
Connector 


16FDC 
Connector 


J3 
J3 
J3 
J3 


The block 
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5-1/4" Floppy Disk Drives 


Device 


Name 


sida 
sfdb 
side 
sfdd 


Board Type(s) 
@ Base Port 


64FDC @ 00h or 16FDC @ 00h 
64FDC @ 00h or 16FDC @ 00h 
64FDC @ 00h or 16FDC @ 00h 
64FDC @ 00h or 16FDC @ 00h 


Uniform Format Floppies 


Device Number 
Major:Minor 


a 
“IO on 


64FDC /16FDC 
Connector 


Uniform format floppies are floppies that have all tracks in the same format and 
all sectors the same size. The sector size may be 128, 256, 512, or 1024 bytes. 
(1024-byte sectors can only be read by special utility programs such as 


reopy.bin and readall.bin.) 


characteristics of the device using the following scheme: 


Minor device = unit + small + dtrack + dual + sside + sdens 


Where: 


unit = 0, 1, 2, or 3 for A, B, C, or D, respectively 
small = 4 for 5-1/4" diskettes; 0 for 8" diskettes 


Exam 


ctrac 
dual 
sside 


sdens 


ples: 


8 for double tracked (not supported); 0 otherwise 
. for. drives in pairs (e.g., Persci);.0 otherwise 
32 for single-sided; 0 for double-sided 

64 for single-density; 0 for double-density 


The minor device number describes the physical 


Listed below are two of the most common uniform floppy types encountered. 


For double-sided, double-density 8" diskettes: 


Device 
Name 


ufda 
ufdb 
ufde 
ufdd 


Device Number 64FDC /16FDC 
Major:Minor Connector 

2:0 J3 

2:1 J3 

2:2 J3 

233 J3 


For double-sided, double-density 5-1/4" diskettes: 


Device 
Name 


usfda 
usfdb 
usfde 


Device Number 64FDC/16FDC 
Major: Minor Connector 

2:4 J2 

Zio J2 

2:6 J2 
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usfdd 


2:7 


64FDC Cartridge Tape Drives 


Device 
Name 


ftab 
ftab0 
ftabl 
ftab2 
fted 
fted0 
ftedl 
fted2 
fftab 
fftab0 
ftabl 
fftab2 
ffted 
ffted0 
ffted1 
- ffted2 


Board Type(s) 


@ Base Port 


64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 
64FDC @ 00h 


STDC Hard Disk Drives 


Device 
Name 


std0 
stdl 


Board Type. 


@ Base Port 


STDC @ F8h 
STDC @ F8h 


STDC @ F8h 
STDC @ F8h 
STDC @ F8h 


STDC @ F8h 
STDC @ E0h 
STDC @ E0h 


STDC @ E0h 
STDC @ E@h 
STDC @ E0h 
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J2 


Device Number 


Major:Minor 


mre Re RR rR OOH Se Dr © 


MB ct Wo Ft © 


pall alice call vall coll wall poll all all valli all col val 


Device Number . 


Major:Minor 


6:0 
6:1 


64FDC 
Connector 


J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 
J2 or J3 . 


. STDC... 


Connector 


Jo 
Jo 
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std127 STDC @ E0h 6:127 J4 
std128 STDC @ E4h 6:128 J5 
std129 STDC @ E4h 6:129 J5 
_ std159 STDC @ E4h 6:159 J5 
std160 STDC @ E4h 6:160 J4 
std161 STDC @ E4h 6:161 J4 
std191 STDC @ E4h 6:191 . aga 
std192 _ STDC @ E8h 6:192 J5 
std193 STDC.-@ E8h 6:193 J5 
std223 STDC @ E8h 63223 J5 
std224 STDC @ E8h 6:224 J4 
std225 STDC @ E8h 6:225 J4 
std255 STDC @ E8h 6:255 J4 


_. 64FDC/16FDC and TU-ART Serial Printers — 


Device Device Number 64FDC/16FDC/TU-ART 
Name Major:Minor Connector 

slptl 7:0 or 7:64 or 7:128 J4 

splt2 7:6 or 7:70 or 7:134 J4 

slpt3 737 or 7:71 or 72135 J5 

slpt4 7:8 or 7:72 or 7:136 J4 

slpts 7:9 or 7:73 or 7:137 J5 

slpt6 7:10 or 7:74 or 7:138 J4 

slpt7 7:11 or 7:75 or 7:139 J5 


CHARACTER DEVICE FILES 


System Character Devices 


Device Board Type(s) Device Number Board 
Name @ Base Port Major:Minor Connector 
null Throwaway Output 330 aa 
timer XXU RTC Timer . 4:0 -- 
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64FDC/16FDC and TU-ART Terminals 


Device 
Name 


ttyl 
tty2 
tty3 
tty4 
ttys 
tty6 
tty7 


Board Type(s) 
@ Base Port 


64FDC @ 00h 

TU-ART #1A @ 60h 
TU-ART #1B @ 70h 
TU-ART #2A @ 80h 
TU-ART #2B @ 90h 
TU-ART #3A @ AOh 
TU-ART #3B @ BOh 


PRI Typewriter (Parallel) Printers 


Device 
Name 


typl 
ty p2 


Board Type 
@ Base Port 


PRI #1 @ 50h 
PRI #2 @ 60h 


Device Number 
Major:Minor 


hk © 


Device Number 
Major:Minor 

29 
26 


PRI and TU-ART Dot Matrix (Paralelle) Printers 


Device 
‘.Name 


Iptl 
lpt2 
lpt3 
1pt4 
Ipts 
lpt6 


Board Type 
@ Base Port 


TU-ART #1A @ 60h or PRI2 @ 60h 


TU-ART #1B @ 70h 
TU-ART #2A @ 80h 
TU-ART #2B @ 90h 
TU-ART #3A @ A0h 
TU-ART #3B @ BOh 


OCTART Serial Printers 


Device 
Name 


qslptl 
qslpt2 
qslpt3 
qslpt4 
qslpts 
qslpt6 
qslpt7 
qslpt8 


qsiptl7 


Board Type 
@ Base Port 


OCTART #1 @CEh 
OCTART #1 @CEh 
OCTART #1 @CEh 
OCTART #1 @CEh 
OCTART #1 @CEh 
OCTART #1 @CEh 
OCTART #1 @CEh 
OCTART #1 @ CEh 


OCTART #2 @ BEh 
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Device Number 
Major: Minor. 


Device Number 
Major:Minor 


9:0 or 9:128 
9:1 or 93129 
9:2 or 9:130 
9:3 or 9:131 
9:4 or 9:132 
9:5 or 9:133 
9:6 or 9:134 
9:7 or 93135 


9:16 or 9:144 


64FDC /16FDC/TU-ART 
Connector 


PRI 
Connector 


J2 
J2 


PRI/TU-ART 
Conneetor. 


OCTART 
Connector 
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qslpt18 OCTART #2 @ BEh 9:17 or 9:145 Jl 
qslpt19 OCTART #2 @ BEh 9:18 or 9:146 dl 
qslpt20 OCTART #2 @ BEh 9:19 or 9:147 J1 
qslpt21 OCTART #2 @ BEh 9:20 or 9:148 J2 
qslpt22 OCTART #2 @ BEh 9:21 or 9:149 J2 
qslpt23 OCTART #2 @ BEh 9:22 or 9:148 J2 
qslpt24 OCTART #2 @ BEh 9:23 or 9:149 J2 
qslpt33 OCTART #3 @ AEh 9:32 or 9:160 Jl 
qslpt34 OCTART #3 @ AEh 9:33 or 9:161 Jl 
qslpt35 OCTART #3 @ AEh 9:34 or 9:162 Jl 
qslpt36 - OCTART #3 @ AEh 9:35 or 9:163 Jl 
qslpt37 OCTART #3 @ AEh 9:36 or 9:164 J2 
qslpt38 OCTART #3 @ AEh 9:37 or 93165 J2 
qslpt39 OCTART #3 @ AEh 9:38 or 9:166 J2 
qslpt40 OCTART #3 @ AEh 9:39 or 9:167 J2 
qslpt49 OCTART #4 @ 9Eh 9:48 or 9:176 Jl 
qslpt50 OCTART #4 @ 9Eh 9:49 or 9:177 Jl 
qslptsl OCTART #4 @ 9Eh 9:50 or 9:178 Jl 
qslpt52 OCTART #4 @ 9Eh 9:51 or 9:179 Jl 
qslpt53 OCTART #4 @ 9Eh 9:52 or 9:180 J2 
qslpt54 OCTART #4 @9Eh 9:53 or 9:181 J2 
qslpt55 OCTART #4 @ 9Eh 9:54 or 9:182 J2 
qslpt56 OCTART #4 @ 9Eh 9:55 or 9:183 J2 
OCTART Terminals 

Device Board Type Device Number OCTART 
Name @ Base Port Major:Minor Connector 
qttyl OCTART #1 @CEh 2:0 Jl 
qtty2 OCTART #1 @ CEh 221 Jl 
qtty3 OCTART #1 @CEh 2:2 na 
qtty4 OCTART #1 @CEh 2:3 Jl 
qtty5 OCTART #1 @CEh 2:4 J2 
qtty6 OCTART #1 @CEh | 2:5 J2 
qtty7 OCTART #1 @CEh 2:6 J2 
qtty8 OCTART #1 @CEh 2:7 J2 
qtty17 OCTART #2 @ BEh 2:16 Jl 
qtty18 OCTART #2 @ BEh 2:17 J1 
qtty19 OCTART #2 @ BEh 2:18 Jl 
qtty20 OCTART #2 @ BEh 2:19 Jl 
qtty21 OCTART #2 @ BEh 2:20 J2 
qtty22 OCTART #2 @ BEh 2:21 J2 
qtty23 OCTART #2 @ BEh 2:22 J2 
qtty24 OCTART #2 @ BEh 2:23 J2 
qtty33 OCTART #3 @ AEh 2:32 Jl 
qtty34 OCTART #3 @ AEh 2:33 Jl 
qtty35 OCTART #3 @ AEh 2:34 Jl 
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qtty36 OCTART #3 @ AEh 2:35 Jl 
qtty37 OCTART #3 @ AEh 2:36 J2 
qtty38 OCTART #3 @ AEh 2:37 J2 
qtty39 OCTART #3 @ AEh 2:38 J2 
qtty 40 OCTART #3 @ AEh 2:39 J2 
qtty49 OCTART #4 @ 9Eh 2:48 Jl 
qtty50 OCTART #4 @ 9Eh 2:49 Jy 
qtty51 OCTART #4 @ 9Eh 2:50 Ja 
qtty52 OCTART #4 @ 9Eh 2:51 Jl 
qtty53 OCTART #4 @ 9Eh 2:52 J2 
qtty54 OCTART #4 @ 9Eh 2:53 J2 
qtty55 OCTART #4 @ 9Eh 2:54 J2 
qtty56 OCTART #4 @ 9Eh 2:55 J2 


IOP/QUADART Serial Printers 


Device Board Type(s) Device Number Quadart 
Name @ Base Port Major:Minor Connector 
qslptl IOP #1 @ CEh, Quadart #1 @ 40h 9:0 or 9:128 J2 
qslpt2 IOP #1 @ CEh, Quadart #1 @ 40h 9:1 or 9:129 J4 
- qslpt3 IOP #1 @ CEh, Quadart #1. @ 40h 9:2 or 93130 STG 
qslpt4 IOP #1 @ CEh, Quadart #1 @ 40h 9:30r9:131 J8 
qslpt5 IOP #1 @CEh, Quadart #2 @ 60h 9:4 or 93132 J2 
qslpt6 IOP #1 @ CEh, Quadart #2 @ 60h 9:5 or 9:133 J4 
qslpt7 IOP #1 @ CEh, Quadart #2 @ 60h 93:6 or 9:134 J6 
qslpt8 - IOP #1-@CEh, Quadart #2@60h ~~ .. 9:7 or 9:135 J8 
qslpt9 IOP #1 @ CEh, Quadart #3 @ 80h 9:8 or 9:136 J2 
qslpt10 IOP #1 @ CEh, Quadart #3 @ 80h 9:9 or 9:137 J4 
qslptll IOP #1 @ CEh, Quadart #3 @ 80h 9:10 or 9:138 J6 
qsipti2 IOP #1 @ CEh, Quadart #3 @ 80h 9:11 or 9:139 J8 
qslpti3 IOP #1 @ CEh, Quadart #4 @ AOh 9:12 or 9:140 J2 
qslptl4 IOP #1 @ CEh, Quadart #4 @ AOh 9:13 or 9:141 J4 
qsipti5 IOP #1 @ CEh, Quadart #4 @ A0h 9:14 or 9:142 J6 
qslpti6 IOP #1 @ CEh, Quadart #4 @ AOh 9:15 or 9:143 J8 
qslptl7 IOP #2 @ BEh, Quadart #5 @ 40h 9:16 or 9:144 J2 
qslpti8 IOP #2 @ BEh, Quadart #5 @ 40h 9:17 or 9:145 J4 
qslpti9 IOP #2 @ BEh, Quadart #5 @ 40h 9:18 or 9:146 J6 
qslpt20 IOP #2 @ BEh, Quadart #5 @ 40h 9:19 or 9:147 J8 
qslpt21 IOP #2 @ BEh, Quadart #6 @ 60h 9:20 or 9:148 J2 
qslpt22 IOP #2 @ BEh, Quadart #6 @ 60h 9:21 or 9:149 J4 
qslpt23 IOP #2 @ BEh, Quadart #6 @ 60h 9:22 or 9:150 J6 
qsipt24 IOP #2 @ BEh, Quadart #6 @ 60h 9:23 or 9:151 J8 
qsipt25 IOP #2 @ BEh, Quadart #7 @ 80h 9:24 or 9:152 J2 
qslpt26 IOP #2 @ BEh, Quadart #7 @ 80h 9:25 or 9:153 J4 
qslpt27 IOP #2 @ BEh, Quadart #7 @ 80h 9:26 or 9:154 J6 
qslpt28 IOP #2 @ BEh, Quadart #7 @ 80h 9:27 or 92155 J8 
qslpt29 IOP #2 @ BEh, Quadart #8 @ A0h 9:28 or 9:156 J2 
qslpt30 IOP #2 @ BEh, Quadart #8 @ AOh 9:29 or 9:157 J4 
qslpt31 IOP #2 @ BEh, Quadart #8 @ AOh 9:30 or 9:158 J6 
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qslpt32 
qslpt33 
qslpt34 
qsipt35 
qslpt36 
qslpt37 
qslpt38 
qslpt39 
qslpt40 
qslpt41 
qslpt42 
qslpt43 
qsipt44 
qsipt45 
qslpt46 


qslpt47 
qslpt48 
qslpt49 
qslpts0 
qslpt51 
qslpt52 
qslpts3 


- gsipts4 : 


qslpt55 
qslpt56 
qslpt57 
qslpt58 


qslpts9 . 


qslpt60 
qslpt61 
qslpt62 
qslpt63 
qslpt64 


IOP #2 @ BEh, Quadart #8 @ AOh 
IOP #3 @ AEh, Quadart #9 @ 40h 
IOP #3 @ AEh, Quadart #9 @ 40h 
IOP #3 @ AEh, Quadart #9 @ 40h 
IOP #3 @ AEh, Quadart #9 @ 40h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #12 @ AOh 
IOP #3 @ AEh, Quadart #12 @ AOh 


IOP #3 @ AEh, Quadart #12 @ A0h 


IOP #3 @ AEh, Quadart #12 @ AOh 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 


IOP #4 @ 9Eh, Quadart #15 @ 80h. 


IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
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9:31 or 93159 
9:32 or 9:160 
9333 or 9:161 
9:34 or 9:162 
9:35 or 9:163 
9:36 or 9:164 
9:37 or 9:165 
9:38 or 9:166 
9: 
9 
9 
9 
9; 
9: 
9: 


39 or 9:167 
340 or 9:168 
41 or 9:169 
242 or 93170 
43 or 93171 
44 or 9:172 
45 or 93173 


oe 


ang or 9: ee 


8 or 9:186. 
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IOP/QUADART Terminals 


Device Board Type(s) Device Number Quadart 
Name @ Base Port Ma jor:Minor Connector 
qttyl IOP #1 @ CEh, Quadart #1 @ 40h 2:0 J2 or J3 
qtty2 IOP #1 @ CEh, Quadart #1 @ 40h 2:1 J4 or J5 
qtty3 IOP #1 @ CEh, Quadart #1 @ 40h 2:2 J6 or J7 
qtty4 IOP #1 @ CEh, Quadart #1 @ 40h 2:3 J8 or J9 
qttys IOP #1 @ CEh, Quadart #2 @ 60h 234 J2 or J3 
qtty6 IOP #1 @ CEh, Quadart #2 @ 60h 2:5 J4 or J5 
qtty7 IOP #1 @ CEh, Quadart #2 @ 60h 2:6 J6 or J7 
qtty8 IOP #1 @ CEh, Quadart #2 @ 60h 2:7 J8 or J9 
qtty9 IOP #1 @ CEh, Quadart #3 @ 80h 2:8 J2 or J3 
qtty10 IOP #1 @ CEh, Quadart #3 @ 80h 2:9 J4 or J5 
qtty11 IOP #1 @ CEh, Quadart #3 @ 80h 2:10 J6 or J7 
qtty12 IOP #1 @ CEh, Quadart #3 @ 80h 2:11 J8 or J9 
qtty13 IOP #1 @ CEh, Quadart #4 @ AOh 2:12 J2 or J3 
qtty14 IOP #1 @ CEh, Quadart #4 @ AOh 2:13 J4 or J5 
qttyls IOP #1 @ CEh, Quadart #4 @ AOh 2:14 J6 or J7 
qtty16 IOP #1 @ CEh, Quadart #4 @ AOh 2:15 J8 or J9 
qtty17 IOP #2 @ BEh, Quadart #5 @ 40h 2316 J2 or J3 
qtty18 IOP #2 @ BEh, Quadart #5 @ 40h 2:17 J4 or JS 
qtty19 IOP #2 @ BEh, Quadart #5 @ 40h 2:18 J6 or J7 
qtty20 IOP #2 @ BEh, Quadart #5 @:40h 2:19 J8 or J9 
qtty21 IOP #2 @ BEh, Quadart #6 @ 60h 2:20 J2 or J3 
qtty22 IOP #2 @ BEh, Quadart #6 @ 60h 2:21 J4 or J5 
.qtty23 -. IOP #2 @ BEh, Quadart #6 @60h. . 2222. . J6 or J7 
qtty24 IOP #2 @ BEh, Quadart #6 @ 60h 2:23 J8 or J9 
qtty25 IOP #2 @ BEh, Quadart #7 @ 80h 2:24 J2 or J3 
qtty26 IOP #2 @ BEh, Quadart #7 @ 80h 2:25 J4 or J5 
qtty27 IOP #2 @ BEh, Quadart #7 @ 80h 2:26 J6 or J7 
qtty28 IOP #2 @ BEh, Quadart #7 @ 80h 2227 J8 or J9 
qtty29 IOP #2 @ BEh, Quadart #8 @ AOh 2:28 J2 or J3 
qtty30 IOP #2 @ BEh, Quadart #8 @ A0h 2:29 J4 or J5 
qtty31 IOP #2 @ BEh, Quadart #8 @ AOh 2:30 J6 or J? 
qtty32 IOP #2 @ BEh, Quadart #8 @ AOh 2231 J8 or J9 
qtty33 IOP #3 @ AEh, Quadart #9 @ 40h 2:32 J2 or J3 
qtty34 IOP #3 @ AEh, Quadart #9 @ 40h 2:33 J4 or J5 
qtty35 IOP #3 @ AEh, Quadart #9 @ 40h 2:34 J6 or J7 
qtty36 IOP #3 @ AEh, Quadart #9 @ 40h 2:35 J8 or J9 
qtty37 IOP #3 @ AEh, Quadart #10 @ 60h 2:36 J2 or J3 
qtty38 IOP #3 @ AEh, Quadart #10 @ 60h 2:37 J4 or J5 
qtty39 IOP #3 @ AEh, Quadart #10 @ 60h 2:38 J6 or J7 
qtty40 IOP #3 @ AEh, Quadart #10 @ 60h 2339 J8 or JQ 
qtty41 IOP #3 @ AEh, Quadart #11 @ 80h 2340 J2 or J3 
qtty42 IOP #3 @ AEh, Quadart #11 @ 80h 2:41 J4 or J5 
qtty43 IOP #3 @ AEh, Quadart #11 @ 80h 2:42 J6 or J7 
qtty44 IOP #3 @ AEh, Quadart #11 @ 80h 2343 J8 or J9 
qtty45 IOP #3 @ AEh, Quadart #12 @ AOh 2:44 J2 or J3 
qtty46 IOP #3 @ AEh, Quadart #12 @ AOh 2:45 J4 or J5 
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qtty47 
qtty 48 
qtty 49 
qtty50 
qttyol 
qtty52 
qtty53 
qtty54 
qtty55 
qtty56 
qtty57 
qtty58 
qtty59 
qtty60 
qtty61 
qtty62 
qtty63 
qtty64 


IOP #3 @ AEh, Quadart #12 @ AOh 
IOP #3 @ AEh, Quadart #12 @ A0h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ A0h 


IOP/QUADART Modems 


Device 
Name 


mttyl 
mtty2 
mtty3 | 
-mtty4 
mtty5 
mtty6 
mtty 7 
mtty8 
mtty9 
mtty10 
mttyll 
mtty12 
mtty13 
mtty14 
mtty15 
mtty16 


mtty17 
mtty18 
mtty19 
mtty20 
mtty21 
_mtty22 
mtty23 
mtty24 
mtty25 
mtty26 
mtty27 


Board Type(s) 
@-Base Port 


IOP #1 @ CEh, Quadart #1 @ 40h 
IOP #1 @ CEh, Quadart #1 @ 40h 
IOP #1 @ CEh, Quadart #1 @ 40h 
IOP: #1 @.CEh, Quadart #1 @ 40h 
IOP #1 @ CEh, Quadart #2 @ 60h 
IOP #1 @ CEh, Quadart #2 @ 60h 
IOP #1 @ CEh, Quadart #2 @ 60h 
IOP #1 @ CEh, Quadart #2 @ 60h 
IOP #1 @ CEh, Quadart #3 @ 80h 
IOP #1 @ CEh, Quadart #3 @ 80h 
IOP #1 @ CEh, Quadart #3 @ 80h 
IOP #1 @ CEh, Quadart #4 @ 80h 
IOP #1 @ CEh, Quadart #4 @ AOh 
IOP #1 @ CEh, Quadart #4 @ AOh 
IOP #1 @ CEh, Quadart #4 @ AOh 
IOP #1 @ CEh, Quadart #4 @ AOh 


IOP #2 @ BEh, Quadart #5 @ 40h 
IOP #2 @ BEh, Quadart #5 @ 40h 
IOP #2 @ BEh, Quadart #5 @ 40h 
IOP #2 @ BEh, Quadart #5 @ 40h 
IOP #2 @ BEh, Quadart #6 @ 60h 
IOP #2 @ BEh, Quadart #6 @ 60h 
IOP #2 @ BEh, Quadart #6 @ 60h 
IOP #2 @ BEh, Quadart #6 @ 60h 
IOP #2 @ BEh, Quadart #7 @ 80h 
IOP #2 @ BEh, Quadart #7 @ 80h 
IOP #2 @ BEh, Quadart #7 @ 80h 
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Device Number 


Major:Minor 


23128 
2:129 


bo bo bod bh bo DS bb bo 
ae ae ee e8 ee ee ee ee ee ae ee 
pony 
cs 
co 


. Connector . ~ 


Quadart 
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mtty 28 
mtty29 
mtty30 
mtty31 


mtty32 
mtty33 
mtty34 
mtty3o5 
mtty 36 
mtty37 
mtty38 
mtty39 
mtty 40 
mtty41 
mtty 42 
mtty43 
mtty 44 
mtty49 
mtty 46 


mtty47 - 


mtty 48 
mtty49 
~ mtty50 
mtty51 
mtty 52 
mtty53 
mtty54 


mtty55 


mtty 96 
mtty57 
mtty 58 
mtty59 
mtty 60 
mtty61 
mtty62 
mtty63 
mtty64 


IOP #2 @ BEh, Quadart #7 @ 80h 
IOP #2 @ BEh, Quadart #8 @ Ath 
IOP #2 @ BEh, Quadart #8 @ A0h 
IOP #2 @ BEh, Quadart #8 @ AOh 


IOP #2 @ BEh, Quadart #8 @ AOh 

IOP #3 @ AEh, Quadart #9 @ 40h 

IOP #3 @ AEh, Quadart #9 @ 40h 

IOP #3 @ AEh, Quadart #9 @ 40h 

IOP #3 @ AEh, Quadart #9 @ 40h 

IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #10 @ 60h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #11 @ 80h 
IOP #3 @ AEh, Quadart #12 @ AOh 
IOP #3 @ AEh, Quadart #12 @ AQh 
IOP #3 @ AEh, Quadart #12 @ AOh 
IOP #3 @ AEh, Quadart #12 @ AOh 


10P #4 @ 9Eh, Quadart #13 @ 40h- 
IOP #4 @ 9Eh, Quadart #13 @ 40h . 


IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #13 @ 40h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #14 @ 60h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #15 @ 80h 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
IOP #4 @ 9Eh, Quadart #16 @ AOh 
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Appendix B 
DISK ERROR MESSAGES 


In the event of a disk error, the Cromix-Plus Operating System displays an error 
message to aid in the diagnosis and correction of the problem. 


FLOPPY DISK ERROR MESSAGES 
When the operating system cannot access a diskette, an error message is 


displayed in the following format: 


<eflop, uflop, or tflop> mode error: Unit uu, Side xx, Track ee, Sector ss, 
Status ffee ; 3 


where: 
Mode... stands for. one of..the following words: 
Select Error occurred in selecting the disk. 
Seek Error occurred in seeking a track on the disk. 
Read Error occurred during a read from the disk. 
Write Error occurred during a write to the disk. 
Home Error occurred in seeking track 0 on the disk. 
Preread Error occurred during preread. 
Read Address Error occurred during a read address 
operation. 
Write Track ‘” Error occurred during a write track operation. 
uu is the unit number (0-3). 
XX is the side number. 
ee is the track (in decimal) where the error occurred. 
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SS 


ff 


ee 


is the sector number (in decimal) where the error occurred. 


is an 8-bit byte displayed in hexadecimal indicating the disk flags 
when the error occurred. 


is the 8 bit status byte displayed in hexadecimal which describes 
the error and the conditions at the time the error occurred. 


The status byte is a hexadecimal number that is either one of the hex values 
in the table below or the combination or two or more of those hex values. The 
bits which correspond to those hex values describe the reasons or the error. 


DISK FLAGS: 


Flag bits set: 


D7 
D6 


D6 


DS 


D4 


D3 


DRO 

BOOT* 
HEADLOAD 
INHIBIT INIT* 


MOTOR ON 

MOTOR TIMEOUT 
AUTOWAIT TIMEOUT 
EQJ 


- Data Request (DRQ)-- 


A high in bit 7 indicates the 16FDC has a byte from the disk or needs a byte 
for the disk according to the current operation. 


Boot* 


A low in bit 6 indicates that SW3 is set to BOOT*. A high in bit 6 indicates 
SW3 is set to MON. 


Headload 


A one in bit 5 indicates the 1793 is requesting the head to load. A zero in 
bit 5 indicates the 1793 is not asking the head to load. 


Inhibit Init* 


A zero in bit 4 indicates that switch 4, INHIBIT* INIT*, is ON. A one in 
bit 4 indicates that switch 4 is off. 


Motor On 
A one in bit three indicates that the 16FDC is requesting the drive motors 
to turn on. A zero in bit three indicates that the 16FDC is no longer 


requesting the drive motors to turn. 
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D2 Motor Timeout 


A one in bit 2 indicates that the motors have been turned off. The motors 
will turn off about 8 seconds after the last disk operation. A zero in bit 
2 indicates the motors have not been turned off. 


D1 Autowait Timeout 


A one in bit 1 indicates that the autowait circuit has been turned off by the 
timer. This will occur about 4 seconds after autowait is turned on. A zero 
in bit 1 indicates that the autowait circuit has not timed out. 


DO End of Job (EOJ) 


A one in bit 0 indicates the command has finished (end of job). 


Status Bits Set and 
Corresponding Hexadecimal Values 


ne a ee are ee ce ee me ee ee A mt ee OS ane me te Se ee ee ee ee ee a ee 


Bits 7 6 5 4 3 2 1 0 
Hex value 80 40 20 10 8 4 2 


If the status byte were 0B, the bits set would be 3, 1, and 0 because the only 
combination of corresponding hexadecimal values that add uP to OB are the ones 
which correspond to bits 3, 1, and 0. 


The following table:describes the malfunctions: -corresponding to the bits set 
in the status byte. 


Status 
Bits 
Set Seek/Home Read/Preread Write 

7 not ready not ready not ready 
6 write protect* 0 write protect 
HY head engaged* record ty pe* 0 
4 seek error record not found record not found 
3 ere error ere error ere error 
Zz track 0* lost data lost data 
1 index* data request* data request* 
0 busy busy busy 
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Status 

Bits 

Set Read Address Write Track 
7 not ready not ready 
6 0 write protect 
5 0° 0 
4 record not found 0 
3 ere error 0 
2 lost data lost data 
1 data request* data request* 
0 busy busy 


The asterisk (*) in the table above indicates that the condition is not the cause 
of the error message, but that it was present when the error occurred. For 
example, if the status byte was 30h during a Seek error, bits 4 and 5 are set (=1). 
This is a Seek error and the head is engaged. The head is supposed to be 
engaged during a seek. Therefore, this condition is not an error, and is marked 
with an asterisk. CRC stands for Cyclic Redundancy Check. It is a verification 
done after a Read operation. A CRC error indicates that an error occurred when 
the data was transferred. 


' During a Read operation, status code 10 or 08 indicates. the data is not readable. | 


This may be caused by bringing the disk close to a magnetie source or by 
scratching or otherwise mishandling the disk. 


“HARD-DISK ERROR MESSAGES 


If the Cromix Operating System encounters an error when accessing a hard disk 
drive, it displays the error in the following format: 


STDC mode error: Unit uu, Block d, Head h, Cyl ec, Stat xx, Error ffss 


where: 
mode . is either Read, Write, Verify, Home, or Seek. 
uu is the minor device number. 
d is the block number in (decimal). 
h is the head number (decima]). 
ee is the cylinder number (decimal). 
XX is the status byte in hexadecimal (indicates type of error). 
ffss is the error number in hexadecimal. The first two digits give 


the fatal disk error and the last two give the system disk error. 
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If bit 0 of the status byte is set to 1, the error numbers refer to the following 
error codes. If bit 1 is set to 1, the fatal error number (ff) refers to the Cromix 
errors in the /equ/jsysequ.asm file (refer to appendix A of the Cromix-Plus 
Programmer's Reference Manual, part number 023-5014). 


STDC Hard-Disk Fatal Errors 


The following error codes are displayed when a fatal disk error occurs: 


00 


01 


02 


03 


04 


05 


06 


07 


Failed to Seek & Read Header during R/W 


An error occurred during an attempt to seek & read the header preceding 
a read/write operation. 


Failed to Seek - Timeout 


The seek did not complete within a specified time. Check the drive 
electronics. 


Fault Occurred during Seek 


During the seek, a fault error occurred within the drive, as reported by 


the drive. This may be any of several errors. 


Failed to Seek to Correct Track 


N 


. The sector header as read off the disk is not. what the drivers expected, 


thus the current disk location is incorrect. 

Failed to Read CRC of Header 

The CRC for the header as read from the disk is incorrect; it is different 
than what was expected. Most likely, the current disk location is incorrect 
or the media surface is damaged. 


Failed to Rezero - Timeout 


A rezero command did not complete within a specified time. Check the 
drive electronics. 


Fault Occurred after Rezeroing 


A fault error occurred within the drive after a rezero command was 
executed. This may be any of several errors. 


Drive not Ready 


The ready signal from the drive is not active. Make sure the drive is 
eonnected properly. 
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03 


09 


0A 


0B 


oc 


oD 


OE 


OF 


10 


11 


12 


Failed to Write - Fault Error 


During the write, a fault error occurred within the drive, as reported by 
the drive. This may be any of several errors. 


Failed to Verify after Write 


After data is written to the disk, it is read back and verified. This error 
occurs if the data cannot be properly verified. 


Failed to Read - Fault Error 


During the read, a fault error occurred within the drive, as reported by 
the drive. This may be any of several errors. 


Failed to Read - CRC Error 


The CRC read from the disk is incorrect; it is different than the expected 
CRC. This error usually means that the data just read is incorrect. 


Failed to Read - Cannot Locate Sector 

The sector cannot be found on the current track. This error oceurs if the 
media surface is damaged or if the controller electronics are not 
functioning properly. 


Surface is Write Protected 


The ‘surface selected. for the current write command is write protected 
and cannot be written to. 


Failed to Seleet Unit 


There was an attempt to select a drive that was not present, or the 
eontroller or drive malfunctioned. 


Failed to Select Head 


The drive has returned a fault error on attempting to select a non-existent 
head. 


Index Pulse Timeout 

Index pulses were not being received properly. 

Seek Range Error 

There was an attempt to access a non-existent track. 
Buffer not Available 


Error occurred while trying to flush write buffers. 
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i 


STDC Hard Disk System Errors 


The following error codes are displayed when a system disk error occurs: 


00 


01 


02 


03 


05 


06 


07 


08 


No Acknowledge Received from Drive 


The drive did not acknowledge a command sent to it. Make sure the drive 
is connected properly. 


Drive Remains BUSY - Acknowledge Stuck Low 


The acknowledge signal from the drive did not go high again after the 
command strobe went inactive. 


Timeout Occurred during Rezeroing 


A rezero command did not complete within a specified time. Check the 
drive electronics. 


Fault Condition Reported by Drive 


A fault condition occurred within the drive, as reported by the drive. This 


_may be any of several errors. 


Failed to Read - CRC Error 


The CRC just read from the disk is incorrect; it is different than the 
SAPeG ES CRC. This error usuadly means the data just read is incorrect. 


Header Off the Disk Does Not Compare with Expected Header 


The sector header as read from the disk is not what the drivers expected. 
Thus, the current disk location is incorrect. 


Failed to Verify after Write Operation 


After data is written to the disk, it is read back and verified. This error 
occurs if the data cannot be properly verified. 


Header or Trailer Error 
The format of the data header or trailer just read is incorrect. 


Track Header Error 


Traek address header is incorrect. 
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Appendix C 


XDOS 


The Cromemeco XXU Disk Operating System (XDOS) is a 32K-byte program 
supplied in ROM with each Cromemeo XXU board. The XDOS program is designed 
to execute beginning at memory location 0000h. Upon power on or reset, the 
diagnostic LED is turned on. XDOS performs a checksum comparison on the ROM, 
followed by a test of the external cache and lower 128K of RAM. Console I/O 
is then initialized and the real-time clock is tested. Console baud rate is 
selected either automatically by searching for carriage returns from the 64FDC 
console device (a break. is sent to inform 3102 terminals to begin sending 
carriage returns), or is preset if switch 1 on the 64FDC is on. The preset baud 
rate is determined by the value of the last byte in the ROM. The following table 
lists the baud rate selected for the various values of this byte. 


BYTE BAUD — 

FFH 9600 (this is the value initially programed) 
TFH 19200 

3FH 9600 

iFH 4800 

UFH © 2400 

07H 1200 © 

03H 300 

01H 150 


00H 110 Any other value-will result in 9600 Baud. 


XDOS will also support several other devices as the system console. The 
default console device, preset baud rate, and boot switch settings may be set 
with the CON command (see below). If switch 1 on the 64FDC is on or if the 
cefault device is not present or cannot be initialized, the console will be set 
to the device connected to the serial channel of the 64FDC. 


If auto boot has been selected (the jumper is installed on the 64FDC or auto 
boot selected through the CON command) and all previous tests have been 
successful, XDOS will perform a boot command. If any of the initial tests have 
been unsuccessful, XDOS will attempt to indicate the nature of the failure by 
blinking the diagnostic LED with a combination of long and short flashes (see 
table below) or by a message to the console. 
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BLINK PATTERN MEANING 

STEADY ON CPU not functioning 

LLLS ROM checksum failed 

LLSL Both external cache and 128K RAM failed 
LLSS Cannot initialize console 


If the 128K RAM test fails but the external cache is OK, XDOS will continue 
executing from ROM and perform the remaining tests. If the console can be 
initialized, XDOS will print a message indicating that memory is bad and that 
it is executing from ROM. This feature allows the technician to use XDOS to 
assist in diagnosing a malfunction. 


COMMAND FORMAT 


All commands must be terminated by pressing the RETURN key. XDOS will not 
respond to any command until the command is properly terminated with a 
RETURN. 


The normal monitor prompt is a semicolon (";"). If a disk drive is selected, the 
prompt changes in order to remind the user which drive is current. All disk 
commands refer to the drive most recently. selected. . 


Wherever a numeric value is expected, a decimal integer may be specified by 
following the number with a decimal point (e.g., 123.). If no decimal point is 
present, the number is assumed to be hexadecimal. Numeric input may also be 
aritmetic expressions using multiplication, division, modulo division, addition,. 
and subtraction with parenthesis to alter the normal precedence of ‘the 
operations. For example a display memory command could be entered as follows: 


DM 100*(5+2) S 10*4 
which would display 40 hex bytes of memory beginning at location 700 hex. 
XDOS_ editing commands 


Console input is line buffered, allowing use of the following editing 
commands: 


Backspace or 
Baekarrow or 


Delete or 

Rubout Deletes previous character 

Control-U Deletes line ue 
Control-S 


CONTROL-S may be used to suspend display output, with CONTROL-@Q used to 
resume display output. 
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Escape/return 


ESCAPE or RETURN may be used to abort the display and return control to 
XDOS. 


Swath operator 


Commands requiring multiple address arguments may be specified in one of two 
ways: either by explicitly declaring the start and stop addresses, or by 
declaring the start address and the swath (or width). This is done by following 
the start address with the letter "S" and the swath width. For example, the 
following two commands are identical in function: 


DM 100 142 Display memory starting at 100h through 142h 
DM 100 S 43 Display memory starting at 100h for 43h bytes 


@ 


This is a dereferencing operator used in arithmetic expressions. This will cause 
the four bytes of memory pointed to by the next expression to be used instead 
of the next expression itself. For example, if the contents of memory location 
1000 hex (4 bytes beginning at 1000 hex) contained 00005000 hex, then the 
_ gommand 


DM @1000 
would begin displaying memory at location 5000 hex. 
# . 
When used as a command this allows setting of the user defined variable #. The 
value to be substituted may follow the command. If no value follows, then the 
old value will be displayed and the new value may then be entered. If only a 
carriage return or an invalid number is entered, the old value is unchanged. 
When used in an expression, the value of the variable # is substituted. The 
initial value is set to the first location of free memory. 
BOOT 
The format of this command when given manually is 


Bx 


followed by a RETURN, where x is an optional disk drive specifier. If x is © 
omitted, XDOS will boot from the drive specified by: 


- Switches 2, 3, 4, and 5 of the 64FDC disk controller 
- The boot value from the console selection entry in the real-time-clock 
RAM (see the discussion on the CON command below) 
The following table describes which device is selected by the various switch 
settings on the 64FDC: 


81 


Cromemeo Cromix-Plus System Administrator's Guide 
C. XDOS Program 


64FDC SWITCHES 


DEVICE 2 3 4 5) 
STD31 OFF OFF OFF OFF 
STD63 OFF OFF ON OFF 
STDO ON OFF OFF ON 
STD1 ON OFF ON ON 
STD2 ON ON OFF ON 
STD3 ON ON ON ON 
STD32 ON OFF OFF OFF 
STD33 ON OFF ON OFF 
STD34 ON ON OFF OFF 
STD35 ON ON ON OFF 
FLOP A OFF OFF OFF ON 
FLOP B OFF OFF ON ON 
FLOP C OFF ON OFF ON 
FLOP D OFF ON ON ON 
SPECIAL OFF ON OFF OFF 
ALTERN OFF ON ON OFF 


The parameter x should be a floppy disk drive letter (in the range A through 

D or UA through UD) or a hard disk specifier of the form STx where x is a number 

between 0 and 255 specifying the partition number of the STDC, or the letters 

SER meaning the block serial device. (See the SER command below to change 
. the serial device.) 


if this parameter is specified, XDOS will attempt to boot from that device. ‘For 
example, the command BC will attempt to boot the system from floppy disk drive 
Cc. 


The boot command may also be performed automatically. This option is enabled 
by a jumper in jumper location 3 on the 64FDC, or by setting bit 7 of the boot 
switch settings parameter in the CON command (see below). 


When the boot command is executed (whether manual or automatic), XDOS will 
display the message "Preparing to boot, ESC to abort", indicating that the boot 
command has been received. A memory test of the lower 512K bytes of memory 
will then be performed. The test and boot may be aborted by typing ESCAPE 
any time during the memory test. Next, a test of the co-processor will be 
performed. If the co-processor is not present or is inoperative, XDOS will hang 
after printing the message: '"Co-processor test ". XDOS will then pause for 
a few seconds while determining the type of disk drive specified (8" or 5") and 
the type of seek. Once XDOS has read the system boot information from the disk 
into memory, it will display the message "Standby," indicating that the boot is 
proceeding normally. 


At this point, the message "No boot" might be displayed, indicating that the disk 
being used does not contain the boot information. The message "Unable to boot" 
might appear, indicating that XDOS is unable to read the boot information from 
the disk. Either of these two conditions must be corrected by booting from 
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another disk and then correcting or repairing the original disk. 


Between display of the messages "Preparing to boot" and "Standby," the 
operator may abort the boot (even if it is an automatic sequence) and return 
control to XDOS by pressing the ESCAPE key on the keyboard. If the boot is 
not aborted and proceeds normally, the operating system being used will come 
up and display its prompt. 


CONSOLE SELECT 

CON 
The default console device and boot parameters are selected and recorded in 
the real-time-clock RAM which is maintained by battery back-up. The following 
prompt is displayed: 


Enter console number: 


1 = OCTART 

2 = RESERVED 

3 = FDC 
Console = 


The OCTART entry is intended for future expansion. 

If the OCTART is selected, the following prompt is displayed: 
Enter channel number [00 - 3F] ? 

The following prompt appears for all console devieesn 
Enter boot switch setting ? 


This value is derived by computing the hex or decimal value of a byte 
constructed from the following bit values: 


bit 7 auto boot flag 
bits 6,5,4 reserved (consider to be 0) 
bits 3,2,1,0 boot device (from table below) 
BITS 

DEVICE 3 2 1 0 

STD31 0 0 0 0 

STD63 0 0 0 1 

SPECIAL 0 0 1 0 

ALTERN 0 0 1 1 

STD32 0 1 0 0 

STD33 0 1 0 1 

STD34 0 1 1 0 

STD35 0 ] 1 1 

FLOP A 1 0 0 0 


(oe) 
aX) 
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FLOP B a 0 0 1 
FLOP C L 0 1 0 
FLOP D 1 0 Ny 1 
STDO 1 1 0 0 
STD1 1 1 0 1 
STD2 1 1 1 0 
STD3 1 1 1 1 


Thus, the response to set boot switch for STD31 with auto boot is: 
Enter boot switch setting? 80 (or 128.) 

The following prompt will also appear in all cases: 
Enter baud rate flag ? 


This value is derived from the following table: 


VALUE BAUD 
FFH 9600 
7FH 19200 
3FH © 9600 
1FH 4800 
OFH 2400 
07H 1200 
03H 300 
GLH . 150 
00H © 110 


Any other value will result in 9600 Baud. 
Thus, the response to set the baud rate to 1200 would be: 


Enter baud rate flag ? 7 


DISPLAY MEMORY 


DM 

DM start 

DM start finish 
DM start S swath 
DM S_ swath 


The letter M following the D is optional. 
The contents of memory is displayed in hexadecimal and ASCII. Each line of 
the display is preceded by the address of the first byte. The ASCII portion is 


displayed to the right of the hexadecimal part, with bit 7 set to 0. Any 
nonprinting ASCII characters are displayed as a period ("."). 
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The default DM swath width is 40h (64 decimal) bytes. 


The first form of the command will display the number of bytes specified by the 
default DM swath starting with the ending address of the previous DM command 
plus 1, or the first byte of free memory if no DM command has been given yet. 
The second form will display the number of bytes specified by the default DM 
swath from the address specified. The third form will display from start to 
finish as specified. The fourth form will display swath bytes beginning at start 
and set the default DM swath to the specified swath. The last form will display 
swath bytes starting with the ending address as above and set the default DM 
swath to the specified swath. 


EXAMINE INPUT PORT 

E port 

EB port 

EW port 
Displays the current contents of the specified input port. The E and EB 
commands examine an 8 bit port while the EW command examines a 16 bit port. 
To examine the internal ports on the XXU board, prefix the command with an 

I. For example, to examine internal port 21 Hex (the hours counter on the 

real-time-clock) use one of the following commands: 

IE 21 . 

IEB 21 
FREE MEMORY 

F 


Prints out the address of the first available byte of free RAM. 


GO 
G addr [string] 


Performs a subroutine call to address addr with a single argument being a 
pointer to the remainder of the input line after the address. 


HEX ARITHMETIC 

H expression 
Evaluates the expression and prints the result in hexadecimal and decimal. The 
expression may consist of numbers, "@", "#", "()" and operators. Valid 
operators are "*" (multiplication), "/" (division), "%" (modulo division), "+" 
(addition), and "~" (subtraction). 
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LOAD AND GO 


L device 
LX device 


The device specified (by the letters A, B, C, D, UA, UB, UC, or UD for floppy 
disks; or STx where x is a number between 0 and 255 for STDC drives; or SER 
for serial) is read in standalone diagnostic format and the selected program 
loaded and executed. If the LX command is used, the first program encountered 
is loaded. If the L command is used, the question 


Do you wish to specify program name (y/n) <n> ? 


is asked. A "y" response to this question will cause the program name to be 
prompted for and the device searched for that particular program. A "2" in 
the input program name will match any single character in the name of programs 
on the device while an "*" will match all following characters. 


For example, the input name "cr?mix" will match "cromix" "cramix", ete, and 
the input name "er*" will match any name that begins with the letters "er". 


A "n" response to the above question will cause the name of each program 
encountered to be displayed followed by a "(y/n) <n> 2?" question. Answering - 
"y" will cause that program to be loaded while any other response will cause 
that program to be skipped and the next encountered name displayed. 


_ If there are no more programs on the device, the message "No program selected" 
is displayed and control returns to XDOS. 
es Sap 205 es 


M source finisn dest 
M source $ swath dest 


Move (or copy) the contents of memory beginning with source and ending with 
finish to memory beginning at dest. The move command can be used to fill a 
block of memory with a constant. (Normally you would use the ZAP command 
described below.) For example, to enter zeros between locations 2000h and 
2008h, use the SM command to enter 0 at location 2000h, and then move 2000h 
through 2007h to 2001h: 


M 2000 2007 2001 or 

M 2000 S 8 2001 
OUTPUT 

O byte port 


OB byte port 
OW word port 
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Writes bytes or words to the output port specified. To write to the internal 
ports of the XXU prefix the command with an I. For example, to turn on the 
LED on the XXU output a 1 to internal port 3 with the following command: 


10 1 3 


QUERY 


Q 

Q 5S swath 

Q start finish string of bytes 
Q start S swath string of bytes 


This command is used to search the specified memory for a given string of 
bytes. The string of bytes is in the same format as in the SM command. If the 
string of bytes is found, 16 bytes are displayed, starting at the first byte which 
matehes. The query is then terminated. The first and second forms of the 
command can only be used after one of the other forms. The first form will 
search beginning after the last address searched by the previous query command 
through the number of bytes specified in the last query swath for the last 
specified string of bytes. The second form is the same as ae. aint except the 
swath size is changed first. 


READ ALL DISK 


RA 
RAX | 


Before this command will be accepted, the disk drive must be selected. (See 
the Select Disk command). 


In the first form, you are prompted for the starting and ending surface and the 
starting and ending cylinders to read. All sectors on the specified surfaces and 
cylinders are read. If errors are encountered, a message will indicate the 
location and cause of the error. In the second form, no prompts are issued and 
the entire device is read. The console will display the current surface and 
cylinder being read. The command may be aborted at any time by typing any 
character on the console. 


READ DISK 


RD start finish sector 
RD start S swath sector 


Before this command will be accepted, the disk drive, surface number, and track 
number must have been specified. (See the Select Disk and Seek command 
descriptions.) 


This command reads enough sectors from disk to fill the specified memory area, 
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or until the end of the disk, starting with the specified sector of the current 
track. The first surface, track, and sector read, and the last surface, track, 
and sector read are then displayed. For example: 

00 002e 01 00 002e 05 


If the last sector on the disk is read before the memory. area is filled, the 
command is terminated and a message is printed indicating the number of bytes 
not read. 


The command is also terminated if an error occurs in reading a sector. 


REPEAT 

REP n command [; command][; command].... 
This command will repeat the specified series of commands (separated by 
semicolons) n times. All commands are valid, although any command which 
requires user input (such as the substitute memory command) will require input 
from the console. 
READ TRACK 

RT address 


Before this command will be accepted, the disk drive, surface number, and track © 
number must have been specified. (See the Select Disk and Seek commands.) 


A track read is performed into memory at address. This read includes the 
formatting characters on the track. 


SEEK 
S track e.g., S 28. 

Seek track 28 (decimal) 
S track side e.g. SIC 1 


Seek track 1C (hex) on side 1 


Before this command will be accepted, the disk drive must be selected. (See 
the Select Disk command.) 


This command seeks the specified traek of the current drive. The first form 
will seek on the current side; the second form will select the side before 
seeking. 


If the second form is specified with a single-sided drive or disk, an error 
message will be printed and the operation terminated. 
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SELECT DISK DRIVE 


The 64FDC will control up to 4 floppy disk drives, labelled A, B,C, and D. It 
ean handle seeks from the slow seek appropriate to the mini floppy to the 
medium speed seek of Cromemco's large floppy. : 


It can control single-density or double-density format, and double-sided as well 
as single-sided drives and disks, including double-sided disks with the Cromemco 
UNIX System V Operating System format (labeled UA, UB, UC or UD). 


To select a drive, type the drive name followed by 2 semicolons for large disk 
and medium seek, or 3 semicolons for small disk and slow seek. For drive names 
A, B, C, and D, XDOS will read the label from the disk and log it in with the 
specification given on the label. For drive names UA, UB, UC and UD, XDOS will 
do a read address to determine density and sector size. These disks must be 
double-sided. 


Disk selection also restores the disk-drive head to home (track 0). If an error 
is encountered while doing this, an error message is printed. 
SELECT SERIAL DEVICE 

.. SER 


Select the device to be used as the block serial device and specify the baud rate 
to be used. The following prompt is displayed: 


Enter device number: - 


1 = OCTART 

2 = RESERVED 

3 = FDC 
Device = 


The OCTART entry is intended for future expansion. 

If the OCTART is selected the following prompt is displayed: 
Enter channel number 00 - 40 ? 

The following prompt appears for all devices: 
Enter baud rate flag ? 


The baud rate flag selects various preset baud rates according to the following 
table: 


VALUE BAUD 


FFH 9600 
7FH 19200 
-3FH 9600 
LP 4800 
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OFH 2400 

07H 1200 

03H 300 

01H 150 

00H 110 Any other value will result in 9600 Baud. 


If the serial device is selected as the same device as the console, the console 
baud rate will be set to the value selected for the serial device. Only one 
channel may be used at any time on the octart. If the OCTART device is 
selected as both the serial and console devices, the channel numbers must be 
the same or the console will be changed to the channel number of the serial 
device. 


SUBSTITUTE MEMORY 


This command is used to substitute memory. The first form will substitute 
memory at the last location substituted, plus 1, (the first free memory location 
if no SM command has been given yet}; the second form will substitute at the 


‘address specified. XDOS displays the address, followed by the contents of the - 


memory byte. One of the following may then be entered: 


1. data~byte value followed by a RETURN. The data-byte value is stored at 
the address of the prompt. The address is then incremented by 1 and 
displayed on the next line. 


2. <A string enclosed between apostrophes ("'"), followed by a RETURN. The 
string is stored beginning at the address of the prompt. The address is then 
incremented past the string and displayed on the next line. 


3. Any number of 1 and 2 above can be entered on one line with a single 
RETURN terminating the line. The address is then incremented past the 
bytes that were stored and the new address is displayed on the next line. 

4. A minus sign ("- "). A minus sign does not store a byte. The address will 

be decremented to the previous address. The minus sign can be used to back 

up to a previous location in case an error was made. 


0. A RETURN only. If no entry is made on the line, the memory byte remains 
unchanged. The address is incremented by 1 and displayed on the next line. 


6. A Period ("."). A period ends the input mode and returns control to XDOS. 
Wherever a numeric value is expected, a decimal integer may be specified in 
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place of a hexadecimal value by following the number with a decimal point. 


The SW form of the command substitutes words while the SL form substitutes 
long words. All forms of input above are allowed except the string form, (see 
number 2 above). 


TEST SYSTEM MEMORY 


T 

T start end 

T start S swath 
TX 

TX start end 

TX start S swath 


This test will perform a pattern write memory test over the specified memory. 
The first form will test the first 512 Kbytes while the next two forms will test 
the specified memory. If TX is used, in addition to the above test, a walking 
1 and walking 0 test is also performed over the specified memory. The results 
of the test are displayed for each 16K block tested in the following format. 


Address: Memory test by 16K blocks 
00000000 +++++++++EEEE---~AAAAA 


The address of the beginning of the section is displayed, followed by a single 
character denoting the results of each 16K block. (One Megabyte is displayed 
. per line on the mousele}- whe following charectsts are ape 


‘ Memory test OK 
- All bytes tested bad (read ffh) - usually means no memory 
E One or more but not all bytes tested bad 
A All bytes tested bad 
VERIFY 


V souree finish dest 
V souree S swath dest 


Verify that the block of memory starting at source through finish (or for length 
swath) is the same as the block starting at dest. The addresses and contents 
are displayed for each discrepancy found. 

The command works by reading bytes from the source and destination and 


comparing them. If a discrepancy is found, it is displayed in the following order: 
source address, souree contents, dest contents, dest address. 


WRITE DISK 
WD start finish sector 
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WD start S swath sector 


Before this command will be accepted, the disk drive, side number, and track 
number must have been specified. (See the Select Disk and Seek commands.) 


This command writes the contents of the specified memory area to the current 
drive, starting with the specified seetor of the current track. The first surface, 
track, and sector written and the last surface, track, and sector written are 
then displayed (e.g., 00 002e 01 00 002e 0x05). 


If the last sector on the drive is written before the memory area has been read, 
the command is terminated and a message is printed indicating the number of 
bytes not written. Partial sectors on Floppy disks will not be written. 


The command is also terminated if an error occurs in writing a sector. 


WRITE TRACK 
WT address 


Before this command will be accepted, the disk drive, surface number, and track 
number must have been specified. (See the Select Disk and Seek commands.) 


A track write is performed from memory at address. For floppy disks the track 
image must be constructed at address. For STDC drives the track wilt De 
initialized then the data area (address + 9)-written to the disk. 


ZAP MEMORY 


Z begin end string of bytes 
Z begin S swath string of bytes 


Memory beginning at begin through end (or for swath bytes) is filled with string 
of bytes. String of bytes is repeated as many times as necessary or truncated 
as necessary to fill the desired memory locations. String of bytes may be 
entered as a combination of numbers and/or quoted strings. 
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Appendix D 


AMEM 


Cromix-Plus contains the mandatory amem driver which handles processor 
memory. The command: 


system[1] mode amem 


displays a number of useful items regarding system memory. The system 
administrator can use the mode utility to change the switches described below. 


External Cache 


The XXU processor board contains external cache memory (external to the cache 
on the 68020). If external cache is used, the processor will work substantially 
faster. The external cache memory can be turned ON or OFF with the command: 


system[1] mode amem ec or mode amem -ec 


_ The file. /ete/startup.cmd should contain the command to turn the external 
cache ON and it should never be turned OFF. The use of external cache memory 
is completely transparent to all user programs. 


Internal Cache 


The 68020 processor chip contains internal cache memory. If internal cache 
is used, the processor will work substantially faster. The internal cache 
memory can be turned ON or OFF with the command: 


system[1] mode amem ic or mode amem -ic 


The file /ete/startup.emd should contain the command to turn the internal 
eache ON. 


The internal cache memory is NOT transparent to user programs in all cases. 
In particular, if a user has self-modifying code, the changes in the code will 
not be reflected in the internal cache memory and the user program might behave 
erratically. The utilities supplied with Cromix-Plus do not use self-modifying 
eode and the same is true for any program written in one of languages (C, 
Pascal, and FORTRAN). It can be safely claimed that the only way to produce 
self-mocifying code is to use the Assembler. The code written in Assembler 
ean be easily made to modify itself, and such a modification will go unnoticed 
except that such a program will most likely not work with the internal cache 
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turned ON. 


Memory Protection 
Cromix-Plus will use the XMM memory management board provided: 


- The XMM board is present in the system 
- The XMM board is enabled 


The XMM board ean be enabled or disabled with the commands: 
system[1] mode amem xmm or mode amem -xmm 


The file /ete/startup.emd should contain the command to turn the XMM board 
ON. 


With the XMM board turned ON, no user program can access memory that was 
not allocated to it by Cromix-Plus. If a program tries to access such memory, 
the user program will be aborted with a Bus Error. The error message will 
indicate the address of the offending instruction. 


We strongly suggest that the XMM never be turned OFF. If a user program needs 
to access such addresses as 1/O space or graphic memory boards, it should 
_. invoke the phys ‘system call to gain access to these addresses. See the 
description of phys system call in the Cromix-Plus_ Programmer's Reference 
Manual. Note that the phys system call can be used only by a privileged user. 


The older versions of compilers ‘contained a bug which prevented the programs 

~ generatec by such compilers to run with XMM enabled. The patchbug utility - 
is supplied and can be used to patch such programs to eliminate this bug. See 
the Cromix-Plus User's Reference Manual. 
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Appendix E 


THE SYSDEF FILE 


Cromix 40 System Generation file 
May 19, 1986 


Device driver names should be entered on appropriate row. A current 
list of devices supported and their driver names can be found at 

the end of this file. Each driver can have a number of integer 
arguments. Those arguments, if any, should follow the driver name. 
The arguments must be separated by white space. The number of arguments 
and their meaning depend on the particular driver. See description 
at the end for the arguments a driver might require. 


“System memory size: 


maxmem 2 % Amount of supported memory expressed 
% in 256K units. 


Character: devices: 


CDEV 01 tty 0 % FDC terminal only 
CDEV 02 % Suggested qtty 

CDEV_ 03 sy sdev % System driver (required) 
CDEV 04 timer % Timer driver (required) 
CDEV 05 % Suggested lpt 

CDEV 06 % Suggested typ 

CDEV 07 % Suggested slpt 

CDEV 08 % Not used 

CDEV 09 % Suggested qslpt 

CDEV 10 % Reserved 

CDEV 11 % Suggested tape 

CDEV 12 % Not used 


BDEV 01 eflop *Cromemeo floppy driver 
BDEV 02 % Suggested uflop 

BDEV 083 allmem % Amem driver (required) 
BDEV 04 % Suggested tflop 

BDEV 05 % Suggested ramdsk 


BDEV 06 stde 1 % STDC driver 
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BDEV 07 smd 0 % Removable part of SMD 0 
BDEV 08 % Not used 


Primitive terminal device: 


3 


RAW raw_fde % FDC primitive terminal driver 


% Root device: 


ROOT none % ROOT none (Means: Ask the operator) 
% ROOT boot (Means: Same as boot disk) 
% ROOT 6 0 (Means: Use device 6:0) 


se 


Customized logon message: 


LOGMSG BootSystem % Any message can be here 


% Default aecess: 


ACCESS rewa.te.re % Files created will have this access % unless it is 
ehanged here ‘ 


a ; SYSTEM PARAMETERS 


NOTE: Be sure you are aware of the ramifications of altering 
these values prior to changing them. See Cromix-Plus User's 
Reference Manual 023-5013 for details. 


d& dl & af 


bufent 30 % Number of memory resident data blocks 

inoent 30 % Number of memory resident inodes 

filent 80 % Number of files which can be opened simultaneously 
chent 32 % Number of files per process 

usrent 24 % Number of process tables 

ptbent 48 % Number of page tables 

mntent 8 % Number of Gevices that can be mounted at any time 
ieckent 16 % Number of locks that can be installed 


96 


Cromemeo Cromix-Plus System Administratcr's Guide 
E. The Sysdef File 


freeent 2048 % Number of bytes in the system memory pool 
msgent 0 % Number of bytes in message pool 

msgmax 0 % Maximum message size 

msgnmb 0 % Maximum number of bytes on one ‘queue 
msgmni 0 % Number of message queues 

msgtql 0 % Number of messages in the system 
shmmax 0 % Maximum shared memory segment size 
shmmni 0 % Number of shared memory identifiers 
shmseg 0 % Number of segments per process 

shmall 0 % Max total shared memory size 

sement 0 % Number of bytes in semaphore pool 
semmni 0 % Number of semaphore identifiers 

semmsl 0: | + ~+=-% Max number of semaphores per identifier 
semopm 0 % Max number of operations par call 
semmnu 0. % Number of undo structures in system 
sain 0 % Number of “Gade entries per er 
shtmni 4 % Number of shared texts in system 

END 


Character device drivers 


tty - Supports terminals on FDC and on TUARTs. The driver name must be followed 
by a list of minor device numbers supported. 
Minor devno Base address 
0 Not applicable (FDC) : at 
6,7 0x60, 0x70 
8,9 0x80, 0x90 
10,11 0xa0, Oxb0 


qtty Supports both octart and IOP terminals. Ensure that the IOPs and/or octarts 
will have the code downloaded (See iostartup.cmd). Arguments are 
IOP/OCTART numbers (1, 2, 3, or 4) which have the quadart.iop or octart.iop 
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code downloaded. 


Octart/IOP # Base address 


1 Oxee 
2 Oxbe 
3 Oxae 
4 0x9e 


sysdev This driver must be present. It provides null device. No arguments. 


timer This driver must be present. It supports the timer and the real time clock. 
No arguments. 


lpt This driver supports parallel printers. Arguments are minor device numbers 
: ‘supported. 


Minor devno Base address Interrupt number 


6 0x60 0x64 
7 0x70 0x74 
8 0x80 0x84 
9 0x90 0x94 
10 — Oxad Oxa4 
11 -Oxb0 : Oxb4 
typ This driver support up to two fully formed character printers (spinwriter). 


Arguments are the supported minor device numbers. 


- Minor‘devno © Base address Interrupt number 


5) 0x50 0x5e 
6 0x60 0x6e 
slpt Supports serial printers on FDC and on TUARTs. The driver name must be 


followed by a list of minor device numbers supported. 


Minor devno Base address 


0 Not applicable (FDC) 
6,7 0x60, 0x70 
8,9 ~ 0x80, 0x90 
10,11 Oxa0, Oxb0 


Applicable minor device numbers may be modified with possible 
communication protocol offsets. Use above numbers for XON/XOFF protocol, 
add 64 for CLQ type printers, add 128 for ETX/ACK protocol. 


qslpt Supports both octart and ICP serial printers. Ensure that the IOPs and/or 
octarts will have the code downloaded (See iostartup.cmd). Arguments are 
IOP/OCTART numbers (1, 2, 3, or 4) which have the quadart.iop or octart.iop 
code downloaded. 
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Octart/IOP # Base address 


1 Oxce 

2 Oxbe 

3 Oxae 

4 0x9e 
tape Supports up to four nine track tape units. The IOPs must be loaded with 
, the tape8.iop or with the tapel6.iop driver. The tapel6.iop driver can be 

used only with a 64K IOP board and it allows block sizes up to 16K. 

Arguments are IO numbers (1, 2, 3, or 4). Minor device numbers 

corresponding to these IO numbers are 0, 1, 2, or 3. 

Octart/IOP # Base address 

1 Oxce 

2 Oxbe 

3 Oxae 

4 0x9e 


Bloek device drivers 


| uflop 


allmem 


tflop 


Supports Tandon or PERSCI drives. No preUmenss: The minor device number 
is defined as 


unit + small + dual 
where 
unit = 0,1, 2, or 3 for A, B, C, D 
small = 4 if 5",.zero if 8" 
‘dual . = 16 if drives in pairs. (PERSCI), zero if not 


Supports Tandon or PERSCI driver in uniform format. No arguments. In 
uniform format all tracks are in the same format, all sectors are the same 
size, sector size might be 128, 256, or 512 bytes. Minor device number 


describes the physical characteristics of the device. Compute the minor 
device number as 


unit + small + dtraek + dual + sside + sdens 


where 
unit = 0,1, 2, or 3 for A, B, C, D 
small = 4 if 5", zero if 8" 
Gtrack = 8 if double tracked (not supported), zero otherwise 
dual = 16 if drives in pairs (PERSCI), zero if not 
sside = 32 if single sided, zero if double sided 
sdens = 


64 if single density, zero if double density 
Supports access to all of system memory (amem). No arguments. 


Supports up to two floppy tapes. Minor device numbers are 
unit + drive + full 

where 
unit = 0 whole tape (6 streams) 

1 streams 0 and 1 only 

2 streams 2 and 3 only 
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3 streams 4 and 5 only 


drive =0 AB 
=4 CD 
full =0 245 segments per stream 
= 8 255 segments per stream (we cannot initialize it) 


ramdsk Supports 4 Ram disks. Use Ramdisk utility to allocate room. No arguments. 


stde Supports up to eight STDC hard disks using up to four controllers. The 
arguments are controller numbers that are supported. Acceptable values 
are 1, 2, 3, and 4. 


Controller # Base address 
- Jj Oxf8 
2 0xe0 
3 Oxe4 
4 _ Oxe8 


If more than one controller is being used the DMA priority cable must be 
hooked up and all STDC boards must have a new IC37 part number 
9020086-2. Also, Rev C STDC boards can only be used as the last board 

in the DMA priority chain. 


‘smd Supports up to four SMD hard disks (two drives on each of two controllers). 
Arguments specify beginning head numbers of drives to be included. 
Arguments are created as follows: 

controller + drive + aed < head 


where’ 

controller =0 controller at hace port 0x38 
128 eontroller at base port 0xe8 

drive =0 for controller drive 0 

64 for controller drive 1 
fixed =0 for removable part of drive 

2 for fixed part of drive 

head = 0-31 beginning head nuraber 


Primitive terminal drivers 


raw_fde Supports primitive character I/O on the terminal connected to 16FDC or 
64FDC board. No arguments. 
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00 - 40, 89 
256KZ board, 45 
512MSU board, 41 


64FDC board, 45 
64FDC/16FDC cables, 46 


Base I/O port addresses, definitions, 59 
Boot drive, selection, 45 


Cable, serial printers, 35 
Connector numbers, devices, definitions, 59 


DC1/DC8 protocol, serial printer, 34 
Device files, definitions, 59 

Device numbers, definitions, 59 

dfd, device files, 59 


Etx/ack protocol, serial printer, 34. 
GID, 25 


IOP board, 51 
IOPMON program, 51 


M-Bus, terminator, 41 
MCUX board, 41 
Modems, installing, 36 
Mtty, device files, 68 
Multiple users, 25 


OCTART board, 48 


Parallel printers, installing, 36 
PRI board, 54 

Priority interrupt cable, 57 
Qslpt, device files, 63, 65 
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Qtty, device files, 64, 67 
QUADART board, 51 


Root, device file, 59 


Serial printers, installing, 34 
Sfd, device files, 60 

Std, device files, 61 

STDC board, 48 


Terminals, installing, 33 
The 2048MSU, 41 

The XXU, 39 

Timer, device file, 62 
Tty, device files, 63 
TU-ART board, 54 

Typ, device files, 63 


UID, 25 


Users, number of, 25 


XDOS, 79 
XPU board, 39 
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